Skip to main content

​
Create a personal access token

Generate tokens from the Immoteur dashboard under Settings → API tokens. Each token inherits the permissions of your workspace, so keep them scoped to automations and CI users. Token creation dialog
  • Copy the token once and store it in a secret manager; it will not be displayed again.
  • Use the bearer format Authorization: Bearer <token> in every API request.
  • Rotate tokens regularly and revoke unused credentials to keep integrations secure.
Validate the token with: 
export IMMOTEUR_TOKEN='<TOKEN>';

curl --fail-with-body --show-error --silent \
  'https://api.immoteur.com/public/v1/auth' \
  -H "Authorization: Bearer $IMMOTEUR_TOKEN";

​
Configure data accesses

Immoteur enforces contractual scopes via data accesses. Align the filters with your agreement so the API returns the expected geographies and publishers. Data access overview
  • Define the list of departments and SIREN/SIRET you are entitled to receive.
  • Review the meta.dataAccessLimit block in API responses to confirm the effective scope.

​
Environment setup tips

  • Inject $IMMOTEUR_TOKEN through environment variables or secret stores rather than hard-coding.
  • Pause schedulers before rotating tokens to avoid 401 Unauthorized responses.
  • Keep a dedicated staging token if you later test non-production environments.