PeopleBatch upsert people

Batch upsert people

Create or update multiple people in one request. The identify array holds up to 1000 operations; the request body is capped at 1 MB. This endpoint accepts identify operations only — a body carrying a track array is rejected with 400 (send those to POST /track/batch, which is gated by the right permission).

curl -X POST "https://api.flameup.ai/api/v1/people/batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "identify": [
    "null"
  ]
}'
{
  "results": [
    {
      "type": "identify",
      "index": 42,
      "success": true,
      "error": "example_string",
      "data": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
        "userId": "example_string",
        "email": "user@example.com",
        "phone": "+1-555-0123",
        "anonymousId": "example_string",
        "traits": {},
        "status": "active",
        "unsubscribed_at": "2024-12-25T10:00:00Z",
        "unsubscribe_reason": "example_string",
        "created_at": "2024-12-25T10:00:00Z",
        "updated_at": "2024-12-25T10:00:00Z"
      }
    }
  ],
  "total": 42
}
POST
/people/batch
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Your Flameup API key (passed as Bearer token)

Your Flameup API key (passed as Bearer token)
Content-Typestring
Required

The media type of the request body

Options: application/json
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Your Flameup API key (passed as Bearer token)

Body

application/json

Responses

resultsarray
totalinteger

Number of results (equals the number of operations sent).