Send a batch of calls

Send a batch of calls

Sends up to 2,500 identify, group, track, page and screen calls to a source in one request.

Note: A request can be up to 500 KB and each call up to 32 KB. A batch of more than 2,500 events still answers 200 but is dropped, so split large imports.

Set up

Use the first option your agent supports.

API (official)

• Base URL: https://api.segment.io
• Endpoint: POST /v1/batch
• Auth: send the header Authorization: Basic $SEGMENT_API_KEY
• Get a key: https://www.twilio.com/docs/segment/connections/find-writekey
• Docs: https://www.twilio.com/docs/segment/connections/sources/catalog/libraries/server/http-api

Note: SEGMENT_API_KEY holds the base64 of <write key>:. EU workspaces send to https://events.eu1.segmentapis.com instead.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.