Back to top

API Documentation

Contact List

Contact list

A Contact list represents a saved search performed on contacts. User can save this list to access the contacts that match criteria later. Each list is composed of four properties: attribute def, which is id for attribute definition on contact, this is the property that serach will be applied against; operator that can be one of ‘eq’ which stands for equality, ‘gte’ for greather than or equal, ‘lte’ for less than or equal, ‘like’ to perform a simple string search, ‘any’ to test if any of values matches contact attribute, ‘all’ to test if all values match contact attribute. Finally value is the actual value(s) that should be used in performing the search

Create a contact list

Create a contact list
POST/contacts/lists

Example URI

POST /contacts/lists
Request
HideShow
Body
{
  "filters": [
    {
      "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
      "value": "cool"
    },
    {
      "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
      "value": "great"
    }
  ],
  "args": {
    "q": "Wow"
  },
  "name": "Wow list"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "331b7eae-3871-419d-8d43-be0535655d3c",
    "created_at": 1760469990.960212,
    "updated_at": 1760469990.960212,
    "deleted_at": null,
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "updated_by": null,
    "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
    "filters": [
      {
        "id": "00697915-fda1-45ff-ad52-edbfaa8d19f9",
        "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
        "operator": "eq",
        "value": "cool",
        "invert": false,
        "type": "contact_list_filter"
      },
      {
        "id": "671b7ff3-244d-4f8b-bc82-3158cd6dbbe0",
        "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
        "operator": "eq",
        "value": "great",
        "invert": false,
        "type": "contact_list_filter"
      }
    ],
    "query": "Wow",
    "args": {
      "filter_type": "and",
      "q": "Wow",
      "crm_tasks": null,
      "flows": null,
      "type": "contact_list_args"
    },
    "name": "Wow list",
    "is_editable": true,
    "touch_freq": null,
    "member_count": 0,
    "type": "contact_list"
  }
}

Update a contact list

Update a contact list
PUT/contacts/lists/:id

Example URI

PUT /contacts/lists/:id
URI Parameters
HideShow
id
string (required) Example: 331b7eae-3871-419d-8d43-be0535655d3c
Request
HideShow
Body
{
  "id": "331b7eae-3871-419d-8d43-be0535655d3c",
  "created_at": 1760469990.960212,
  "deleted_at": null,
  "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
  "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
  "filters": [
    {
      "id": "00697915-fda1-45ff-ad52-edbfaa8d19f9",
      "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
      "operator": "eq",
      "value": "cool",
      "invert": false,
      "type": "contact_list_filter"
    },
    {
      "id": "671b7ff3-244d-4f8b-bc82-3158cd6dbbe0",
      "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
      "operator": "eq",
      "value": "great",
      "invert": false,
      "type": "contact_list_filter"
    }
  ],
  "args": {
    "q": "OMG",
    "filter_type": "and"
  },
  "name": "Wow list",
  "is_editable": true,
  "touch_freq": null,
  "member_count": 0,
  "type": "contact_list"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "331b7eae-3871-419d-8d43-be0535655d3c",
    "created_at": 1760469990.960212,
    "updated_at": 1760469991.097788,
    "deleted_at": null,
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "updated_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
    "filters": [
      {
        "id": "00697915-fda1-45ff-ad52-edbfaa8d19f9",
        "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
        "operator": "eq",
        "value": "cool",
        "invert": false,
        "type": "contact_list_filter"
      },
      {
        "id": "671b7ff3-244d-4f8b-bc82-3158cd6dbbe0",
        "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
        "operator": "eq",
        "value": "great",
        "invert": false,
        "type": "contact_list_filter"
      }
    ],
    "query": "OMG",
    "args": {
      "filter_type": "and",
      "q": "OMG",
      "crm_tasks": null,
      "flows": null,
      "type": "contact_list_args"
    },
    "name": "Wow list",
    "is_editable": true,
    "touch_freq": null,
    "member_count": 0,
    "type": "contact_list"
  }
}

List all contact list for current user

List all contact list for current user
GET/contacts/lists

Example URI

GET /contacts/lists
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "0a0ea77b-3eca-48ef-ae2c-1c6ef07971d8",
      "created_at": 1760469990.489729,
      "updated_at": 1760469990.489729,
      "deleted_at": null,
      "created_by": null,
      "updated_by": null,
      "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
      "filters": [
        {
          "id": "5b248527-e67c-4f6c-bbef-a88884c0e8e5",
          "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
          "operator": "eq",
          "value": "Warm",
          "invert": false,
          "type": "contact_list_filter"
        }
      ],
      "query": null,
      "args": {
        "filter_type": "and",
        "q": null,
        "crm_tasks": null,
        "flows": null,
        "type": "contact_list_args"
      },
      "name": "Warm",
      "is_editable": true,
      "touch_freq": 60,
      "member_count": 0,
      "type": "contact_list"
    },
    {
      "id": "9ef692d9-57a6-4842-afb3-324de2b6fd39",
      "created_at": 1760469990.492184,
      "updated_at": 1760469990.492184,
      "deleted_at": null,
      "created_by": null,
      "updated_by": null,
      "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
      "filters": [
        {
          "id": "d76092da-bd04-44c5-bc4a-077abc8aa32a",
          "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
          "operator": "eq",
          "value": "Hot",
          "invert": false,
          "type": "contact_list_filter"
        }
      ],
      "query": null,
      "args": {
        "filter_type": "and",
        "q": null,
        "crm_tasks": null,
        "flows": null,
        "type": "contact_list_args"
      },
      "name": "Hot",
      "is_editable": true,
      "touch_freq": 30,
      "member_count": 0,
      "type": "contact_list"
    },
    {
      "id": "36c95303-f491-478e-90db-474d935fc5de",
      "created_at": 1760469990.493983,
      "updated_at": 1760469990.493983,
      "deleted_at": null,
      "created_by": null,
      "updated_by": null,
      "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
      "filters": [
        {
          "id": "c7320f80-9dcc-44e9-ae32-ae2c284d89cc",
          "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
          "operator": "eq",
          "value": "Past Client",
          "invert": false,
          "type": "contact_list_filter"
        }
      ],
      "query": null,
      "args": {
        "filter_type": "and",
        "q": null,
        "crm_tasks": null,
        "flows": null,
        "type": "contact_list_args"
      },
      "name": "Past Client",
      "is_editable": true,
      "touch_freq": null,
      "member_count": 0,
      "type": "contact_list"
    },
    {
      "id": "2db231c7-44d8-4d80-8e70-d339b2bd629a",
      "created_at": 1760469990.495607,
      "updated_at": 1760469990.495607,
      "deleted_at": null,
      "created_by": null,
      "updated_by": null,
      "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
      "filters": [
        {
          "id": "ab15ef6e-b75a-4ca4-9daf-80a2afc36f7b",
          "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
          "operator": "eq",
          "value": "IOSAddressBook",
          "invert": false,
          "type": "contact_list_filter"
        }
      ],
      "query": null,
      "args": {
        "filter_type": "and",
        "q": null,
        "crm_tasks": null,
        "flows": null,
        "type": "contact_list_args"
      },
      "name": "iOS",
      "is_editable": true,
      "touch_freq": null,
      "member_count": 0,
      "type": "contact_list"
    },
    {
      "id": "331b7eae-3871-419d-8d43-be0535655d3c",
      "created_at": 1760469990.960212,
      "updated_at": 1760469991.097788,
      "deleted_at": null,
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "updated_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
      "filters": [
        {
          "id": "00697915-fda1-45ff-ad52-edbfaa8d19f9",
          "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
          "operator": "eq",
          "value": "cool",
          "invert": false,
          "type": "contact_list_filter"
        },
        {
          "id": "671b7ff3-244d-4f8b-bc82-3158cd6dbbe0",
          "attribute_def": "5b3c994e-7569-4df8-b8db-f37421a684f7",
          "operator": "eq",
          "value": "great",
          "invert": false,
          "type": "contact_list_filter"
        }
      ],
      "query": "OMG",
      "args": {
        "filter_type": "and",
        "q": "OMG",
        "crm_tasks": null,
        "flows": null,
        "type": "contact_list_args"
      },
      "name": "Wow list",
      "is_editable": true,
      "touch_freq": null,
      "member_count": 0,
      "type": "contact_list"
    },
    {
      "id": "5530777c-b1db-4b99-ada5-6ee33ff3b2ff",
      "created_at": 1760469991.024139,
      "updated_at": 1760469991.024139,
      "deleted_at": null,
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "updated_by": null,
      "brand": "cc31c62f-a274-43c0-b079-ef04ac46cc86",
      "filters": null,
      "query": null,
      "args": {
        "filter_type": "and",
        "q": null,
        "crm_tasks": null,
        "flows": null,
        "type": "contact_list_args"
      },
      "name": "Empty List",
      "is_editable": true,
      "touch_freq": null,
      "member_count": 0,
      "type": "contact_list"
    }
  ],
  "info": {
    "count": 6,
    "total": 0
  }
}

Delete contact list

Delete contact list
DELETE/contacts/lists/:id

Example URI

DELETE /contacts/lists/:id
URI Parameters
HideShow
id
string (required) Example: 331b7eae-3871-419d-8d43-be0535655d3c
Response  204

List all available contact search filters that can be appiled to contacts

List all available contact search filters that can be appiled to contacts
GET/contacts/lists/options

Example URI

GET /contacts/lists/options
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "tag": {
      "values": [],
      "operator": "all"
    }
  }
}

Generated by aglio on 14 Oct 2025