Live Push User Segmentation
Request Details
Item | Value |
Description | Sends a segmentation event whenever a user enters or exits a segment or segment group. |
Method | POST |
Endpoint | Client provided, must begin with https:// |
Content Type | application/json |
Recommended Request Authentication
See Data Push Overview for supported authentication types.
Request Body
Field Name |
Sample Value |
Format |
Description |
user_id |
10 | Integer | CrowdTwist user ID. |
email_address | test@ct.com | String | User’s email address. |
third_party_id | user-123 | String | User’s third-party ID. |
type | segment | String | Will be “segment” if the event pertains to a single segment or “group” for a segment group. |
name | Users in New York | String | The name of the segment or segment group. |
subscription_id |
200 |
Integer |
Unique identifier for the segment or segment group. |
event | entered | String | Will be either “entered” or “exited” if the member has been added or removed from the segment or segment group. |
trigger | segment criteria | String | The trigger for the event. Will be “segment criteria” or “segment disabled.” |
date_occurred | 2022-07-27T18:29:18Z | String (ISO 8601) | The time the event occurred. |
Sample Request
{
"user_id": 10,
"email_address": "joe@example.com",
"third_party_id": "user-123",
"type": "segment",
"name": "Users in New York",
"subscription_id": 200,
"event": "entered",
"trigger": "segment criteria",
"date_occurred": "2022-07-27T18:29:18Z"
}