API Documentation

Integrate with Candit API

Connect Candit to your existing HR systems with REST API and webhook scenarios.

API Endpoints

Core endpoints to get started

curl -X POST https://your-api-host/v1/public/contact \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Recruiter",
    "email": "jane@example.com",
    "company": "Candit Demo",
    "message": "I would like to discuss the API details."
  }'
GET/v1/health

Verifies service status and basic runtime readiness.

GET/v1/auth/providers

Lists the active sign-in providers and auth options.

POST/v1/public/contact

Stores contact and demo requests.

POST/v1/integrations/webhooks/:provider

Processes events coming from the supported webhook providers.

Authentication

Access protected endpoints with JWT and provider-based auth flows.

Webhook Notifications

Track interview, evaluation, application and process events per provider.

Rate Limits

Rate limits are applied to keep the system running reliably.

Next step

Need help with API usage?

Our technical team is ready to help you with API access and webhook flows.