List Segments
Example Request
$ curl https://api.intercom.io/segments\n-H 'Authorization:Bearer <Your access token>' \\\n-H 'Accept:application/json'HTTP/1.1 200 OK\n\n{\n \"type\": \"segment.list\",\n \"segments\": [\n {\n \"created_at\": 1393613031,\n \"id\": \"5310d8e7598c9a0b24000002\",\n \"name\": \"Active\",\n \"type\": \"segment\",\n \"updated_at\": 1393613031\n },\n {\n \"created_at\": 1393613030,\n \"id\": \"5310d8e6598c9a0b24000001\",\n \"name\": \"New\",\n \"type\": \"segment\",\n \"updated_at\": 1393613030\n },\n {\n \"created_at\": 1393613031,\n \"id\": \"5310d8e7598c9a0b24000003\",\n \"name\": \"Slipping Away\",\n \"type\": \"segment\",\n \"updated_at\": 1393613031\n }\n ]\n}You can list the user segments for your App by sending a GET request to https://api.intercom.io/segments. Company segments can be listed by sending a GET request to https://api.intercom.io/segments?type=company.
You can also include counts in your segment model in the response if you add the parameter include_count=true in the request. Note that this is only relevant for user segments.
$ curl 'https://api.intercom.io/segments?include_count=true'
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'HTTP/1.1 200 OK
{
"type": "segment.list",
"segments": [
{
"type": "segment",
"id": "56cc69cd8618d37b4500000c",
"name": "Active",
"created_at": 1456237005,
"updated_at": 1487064099,
"person_type": "user",
"count": 3
},
{
"type": "segment",
"id": "56cc69cc8618d37b4500000b",
"name": "New",
"created_at": 1456237004,
"updated_at": 1473241975,
"person_type": "user",
"count": 0
},
{
"type": "segment",
"id": "56cc69cd8618d37b4500000d",
"name": "Slipping Away",
"created_at": 1456237005,
"updated_at": 1473241975,
"person_type": "user",
"count": 0
},
{
"type": "segment",
"id": "56e6f1f2b7ebc2061200000d",
"name": "test3WebSession",
"created_at": 1457975794,
"updated_at": 1473241976,
"person_type": "user",
"count": 1
}
]
}Segment List
| Attribute | Type | Description |
|---|---|---|
| type | string | value is 'segment.list' |
| segments | array | A list of segment objects |
| pages | object | Optional. A pagination object, which may be empty, indicating no further pages to fetch. |
Returns
A list of segment objects for the App. The result may also have a pages object if the response is paginated.