Skip to main content
POST
/
v1
/
custom-connectors
/
{connector_id}
/
ingest
/
typed
Ingest typed first-party events
curl --request POST \
  --url https://api.adapter.com/v1/custom-connectors/{connector_id}/ingest/typed \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "external_id": "ext-123",
      "timestamp": "2023-11-07T05:31:56Z",
      "payload": {},
      "metadata": {
        "batch": "2026-06-01",
        "env": "staging"
      }
    }
  ]
}
'
{
  "status": "<string>",
  "events": 123,
  "external_ids": [
    "<string>"
  ]
}

Authorizations

​
Authorization
string
header
required

Pass your pk_live_... API key as a Bearer token.

Path Parameters

​
connector_id
string
required

Body

application/json
​
items
TypedIngestItem · object[]
required
Minimum array length: 1

Response

Successful Response

​
status
string
required

Always 'accepted'.

Example:

"accepted"

​
events
integer
required

Number of events accepted.

Example:

1

​
external_ids
string[]

external_id of each accepted event, in submission order. Useful for callers that want to look up the resulting canonical doc.

Example:
["ext-123"]