Events

Get an event

Changed on

Scope: account:read.

get/v1/events/{event_id}

Request

  • Base URL: https://api.recruitmcp.com
  • URL: https://api.recruitmcp.com/v1/events/{event_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: account:read)

Path parameters

event_idstring required

Headers

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

Response

The event.

idstring required
object'event' required
type'job.completed' | 'job.failed' | 'contacts.completed' | 'enrollment.created' | 'enrollment.completed' | 'enrollment.failed' | 'action.sent' | 'action.failed' | 'action.awaiting_approval' | 'reply.received' | 'invite.accepted' | 'account.connected' | 'account.paused' | 'account.disconnected' | 'outreach.cap_reached' | 'credits.low' | 'credits.expiring' | 'credits.purchased' | 'credits.granted' | 'credits.used' | 'credits.payg_alert' required
created_atstring date-time required
customer_idstring nullable
dataobject required

The object the event is about. Fields depend on type.

Example response

{
  "id": "evt_job_job_3c4d_20261013093000",
  "object": "event",
  "type": "job.completed",
  "created_at": "2026-10-13T09:30:00Z",
  "customer_id": null,
  "data": {
    "job_id": "job_3c4d5e6f7a8b9c0d1e",
    "status": "completed"
  }
}

Changes

  • ad27b35513a6Revision changes
    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status

    • warning

      added the new approval_forced enum value to the / response property for the response status