Skip to main content

Developers: API keys, webhooks, and integrations

The Organization > Developers page gathers everything you need to connect RecrutAuto to your information system.

Organization API keys

API keys let you call the REST API and the MCP server on behalf of the organization:

  • format: ra_live_… (production) and ra_test_… (test);
  • the key is displayed only once at creation — store it in your secrets manager;
  • each key can be revoked independently;
  • availability: 1 key on Business, unlimited on Enterprise.

For individual use (personal scripts, MCP connector), prefer personal tokens.

Outbound webhooks — Business and Enterprise

Webhooks notify your information system in real time (candidate qualified, reply received, appointment scheduled…):

  1. From Organization > Developers, add a webhook URL
  2. Select the events to receive
  3. Verify the signature (X-RecrutAuto-Signature, HMAC-SHA256 of the body with your secret) before processing each delivery
  4. Failures are retried with backoff; deliveries can be reviewed from the page

Slack and Microsoft Teams integrations — Business and Enterprise

Receive the organization's notifications (candidate replies, scheduled interviews…) directly in a channel:

  1. Organization > Developers > Integrations
  2. Choose Slack or Teams and follow the OAuth authorization
  3. Select the destination channel and the event types
info

ATS integrations (BoondManager, Greenhouse, Lever…) are still configured per recruiter — see ATS Integrations.