Events

List events

Changed on Oct 20, 2026

Everything that happened on the account in the last 30 days: jobs, contact lookups, enrollments, replies, accounts, and credits. A customer key sees only its customer's events. The same events are pushed to webhook endpoints.

Scope: account:read.

get/v1/events

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/events
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)

Query parameters

typestring

One event type. Same filter as types.

typesstring[]

Event types, comma separated. Default all.

customer_idstring

Only events from this customer. Use none for account-level events.

created_afterstring date-time

Only events after this time.

limitinteger

How many items to return. Default 25, at most 100.

cursorstring

next_cursor from the previous response. An invalid cursor is 400 invalid_request, message Invalid cursor.

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

Events, newest first.

object'list' required

next_cursorstring nullable required

Pass as cursor for the next page. Null on the last page.

has_moreboolean required

Example response

{
  "data": [
    {
      "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

Oct 20, 2026ad27b35513a6 Revision 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

Operation history