Add members to a segment in bulk. This endpoint accepts 1 to 10,000 members per request. Members are identified by email, phone number, and/or client user ID. The request is validated, queued for asynchronous processing, and a unique batch job ID is returned for tracking the status.

Request Limits:

• Minimum: 1 member per request
• Maximum: 10,000 members per request
• Each individual record must not exceed 1 MiB (1,048,576 bytes); oversized records are rejected with a 413 in the job results and are not processed
• At least one identifier (email, phone, or clientUserId) required per member

Processing:

• Jobs are processed asynchronously
• Use the batch job ID to check status via GET /v2/bulk/job/{bulkJobId}
• Results available as downloadable .jsonl file when completed

Scopes Required: [segments:all]

Default Rate Limit: 100 requests per second