Back to top

API Documentation

Lead Channel

Overview

A LeadChannel represents an endpoint through which leads are captured and routed

Field Type Association Description
id uuid Internal identifier of the lead channel
brand uuid Brand to which this lead channel belongs
created_at number Timestamp of when this lead channel was created
updated_at number Timestamp of when this lead channel was last updated
deleted_at number Timestamp of when this lead channel was deleted (if applicable)
capture_number number Number of leads captured by this channel so far
last_capture_date number Timestamp of the most recent lead captured
mls string[] List of code names of relevant MLS to search for listings mentioned by incoming leads
is_default boolean Whether this lead channel is the default lead channel for the brand

Get Lead Channel of brand

Get Lead Channel of brand
GET/brands/:brand/leads/channels

brand (uuid) ID of the brand

Example URI

GET /brands/:brand/leads/channels
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "8f072d40-417a-49d7-a452-b4f053e8cae2",
      "name": "Default Route",
      "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
      "capture_number": 0,
      "mls": null,
      "is_default": true,
      "type": "lead_channel",
      "created_at": 1778872195.362941,
      "updated_at": 1778872195.362942,
      "deleted_at": null,
      "last_capture_date": null,
      "rules_count": "1",
      "title": null
    },
    {
      "id": "6cbfb9c5-cd90-4742-bc69-07cc9a335266",
      "name": null,
      "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
      "capture_number": 0,
      "mls": null,
      "is_default": false,
      "type": "lead_channel",
      "created_at": 1778872195.445528,
      "updated_at": 1778872195.44553,
      "deleted_at": null,
      "last_capture_date": null,
      "rules_count": "1",
      "title": null
    }
  ],
  "info": {
    "count": 2,
    "total": 2
  }
}

Create a Lead Channel

Create a Lead Channel
POST/brands/:brand/leads/channels

Example URI

POST /brands/:brand/leads/channels
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
Request
HideShow
Body
{
  "protocol": "JSON"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "6cbfb9c5-cd90-4742-bc69-07cc9a335266",
    "name": null,
    "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
    "capture_number": 0,
    "mls": null,
    "is_default": false,
    "type": "lead_channel",
    "created_at": 1778872195.445528,
    "updated_at": 1778872195.44553,
    "deleted_at": null,
    "last_capture_date": null,
    "rules_count": "1",
    "title": null
  }
}

Delete a Lead Channel

Delete a Lead Channel
DELETE/brands/:brand/leads/channels/:leadChannelId

Example URI

DELETE /brands/:brand/leads/channels/:leadChannelId
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
channel
string (required) Example: 6cbfb9c5-cd90-4742-bc69-07cc9a335266
Request
HideShow
Body
{
  "brand": "4ccfc7da-8ebf-479d-90ee-0846fde945ec"
}
Response  204

Update a Lead Channel

Update a Lead Channel
PUT/brands/:brand/leads/channels/:leadChannelId

Example URI

PUT /brands/:brand/leads/channels/:leadChannelId
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
channel
string (required) Example: 6cbfb9c5-cd90-4742-bc69-07cc9a335266
Request
HideShow
Body
{
  "name": "New Name"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "6cbfb9c5-cd90-4742-bc69-07cc9a335266",
    "name": "New Name",
    "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
    "capture_number": 0,
    "mls": null,
    "is_default": false,
    "type": "lead_channel",
    "created_at": 1778872195.445528,
    "updated_at": 1778872194.700663,
    "deleted_at": null,
    "last_capture_date": null,
    "rules_count": "1",
    "title": null
  }
}

Rule

Overview

Rule

A LeadChannelRule determines how leads are routed based on specified conditions.

Field Type Association Description
id uuid Internal identifier of the lead routing rule
created_at number Timestamp of when this rule was created
updated_at number Timestamp of when this rule was last updated
created_by uuid User who created this rule
kind ‘AND’ | ‘OR’ Logical operator for combining conditions (AND or OR)
is_default boolean Whether this rule is the default rule for the channel
order number Order of this rule in the routing sequence
conditions uuid[] lead_channel_rule.conditions List of condition identifiers associated with this rule
flow uuid | null lead_channel_rule.flow Identifier of the flow to enroll leads into (if applicable)
target ‘Group’ | ‘User’ | ‘Brand’ Type of target entity this rule applies to
group uuid | null lead_channel_rule.group Identifier of the group (if target is ‘Group’)
user uuid | null lead_channel_rule.user Identifier of the user (if target is ‘User’)
brand uuid | null lead_channel_rule.brand Identifier of the brand (if target is ‘Brand’ or ‘User’)

RuleCondition

A LeadChannelRuleCondition specifies a single criterion used to evaluate and filter leads.

Field Type Association Description
id uuid Internal identifier of the condition
created_at number Timestamp of when this condition was created
order number Order of this condition in the rule’s conditions sequence
field string Field name to be evaluated
operator ‘eq’ | ‘any’ | ‘all’ | ‘gte’ | ‘lte’ Operator to be used for evaluation
value any Value against which the field will be evaluated
negated boolean Whether to negate the condition’s evaluation

Create a lead channel rule

Create a lead channel rule
POST/brands/:brand/leads/channels/:id/rules

Example URI

POST /brands/:brand/leads/channels/:id/rules
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
channel
string (required) Example: 6cbfb9c5-cd90-4742-bc69-07cc9a335266
associations
string (required) Example: lead_channel_rule.conditions,lead_channel_rule.brand,lead_channel_rule.user
Request
HideShow
Body
{
  "target": "User",
  "kind": "AND",
  "order": 1,
  "flow": null,
  "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
  "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
  "conditions": [
    {
      "field": "price",
      "operator": "gte",
      "value": 500000,
      "order": 1
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "4c213e89-d4f3-4544-b061-03f32e34847c",
    "created_at": 1778872194.700663,
    "updated_at": 1778872194.700663,
    "deleted_at": null,
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "channel": "6cbfb9c5-cd90-4742-bc69-07cc9a335266",
    "kind": "AND",
    "order": 1,
    "target": "User",
    "user": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "last_seen_at": null,
      "email_signature": null,
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "current_time": "2:09 PM - Friday May 15, 2026",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": "4ccfc7da-8ebf-479d-90ee-0846fde945ec",
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    },
    "brand": {
      "id": "fcb549a4-87d7-46ad-888e-01277dc70110",
      "created_at": 1778872194.773431,
      "updated_at": 1778872194.773431,
      "palette": null,
      "assets": null,
      "messages": null,
      "parent": null,
      "name": "LeadChannel",
      "deleted_at": null,
      "training": false,
      "brand_type": "Team",
      "parents": null,
      "type": "brand",
      "hostnames": null,
      "member_count": 1,
      "base_url": "https://irish.rechat.com"
    },
    "is_default": false,
    "conditions": [
      {
        "id": "e8490182-b5ab-4791-bfbb-1747ab093d55",
        "created_at": 1778872194.700663,
        "rule": "4c213e89-d4f3-4544-b061-03f32e34847c",
        "order": 1,
        "field": "price",
        "operator": "gte",
        "value": 500000,
        "negated": false,
        "type": "lead_channel_rule_condition"
      }
    ],
    "type": "lead_channel_rule"
  }
}

Get rules for a lead channel

Get rules for a lead channel
GET/brands/:brand/leads/channels/:id/rules

Example URI

GET /brands/:brand/leads/channels/:id/rules
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
channel
string (required) Example: 6cbfb9c5-cd90-4742-bc69-07cc9a335266
associations
string (required) Example: lead_channel_rule.conditions,lead_channel_rule.brand,lead_channel_rule.user
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "4c213e89-d4f3-4544-b061-03f32e34847c",
      "created_at": 1778872194.700663,
      "updated_at": 1778872194.700663,
      "deleted_at": null,
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "channel": "6cbfb9c5-cd90-4742-bc69-07cc9a335266",
      "kind": "AND",
      "order": 1,
      "target": "User",
      "user": {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "2:09 PM - Friday May 15, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": "4ccfc7da-8ebf-479d-90ee-0846fde945ec",
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      },
      "brand": {
        "id": "fcb549a4-87d7-46ad-888e-01277dc70110",
        "created_at": 1778872194.773431,
        "updated_at": 1778872194.773431,
        "palette": null,
        "assets": null,
        "messages": null,
        "parent": null,
        "name": "LeadChannel",
        "deleted_at": null,
        "training": false,
        "brand_type": "Team",
        "parents": null,
        "type": "brand",
        "hostnames": null,
        "member_count": 1,
        "base_url": "https://irish.rechat.com"
      },
      "is_default": false,
      "conditions": [
        {
          "id": "e8490182-b5ab-4791-bfbb-1747ab093d55",
          "created_at": 1778872194.700663,
          "rule": "4c213e89-d4f3-4544-b061-03f32e34847c",
          "order": 1,
          "field": "price",
          "operator": "gte",
          "value": 500000,
          "negated": false,
          "type": "lead_channel_rule_condition"
        }
      ],
      "type": "lead_channel_rule"
    },
    {
      "id": "1b900ec4-8628-43ba-88f7-e752085fe6f9",
      "created_at": 1778872194.700663,
      "updated_at": 1778872194.700663,
      "deleted_at": null,
      "created_by": null,
      "channel": "6cbfb9c5-cd90-4742-bc69-07cc9a335266",
      "kind": "AND",
      "order": 32767,
      "target": "User",
      "user": {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "current_time": "2:09 PM - Friday May 15, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": "4ccfc7da-8ebf-479d-90ee-0846fde945ec",
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      },
      "brand": {
        "id": "fcb549a4-87d7-46ad-888e-01277dc70110",
        "created_at": 1778872194.773431,
        "updated_at": 1778872194.773431,
        "palette": null,
        "assets": null,
        "messages": null,
        "parent": null,
        "name": "LeadChannel",
        "deleted_at": null,
        "training": false,
        "brand_type": "Team",
        "parents": null,
        "type": "brand",
        "hostnames": null,
        "member_count": 1,
        "base_url": "https://irish.rechat.com"
      },
      "is_default": true,
      "conditions": null,
      "type": "lead_channel_rule"
    }
  ],
  "info": {
    "count": 2,
    "total": 0
  }
}

Reorder rules for a lead channel

Reorder rules for a lead channel
PUT/brands/:brand/leads/channels/:id/rules/sort

Example URI

PUT /brands/:brand/leads/channels/:id/rules/sort
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
channel
string (required) Example: 6cbfb9c5-cd90-4742-bc69-07cc9a335266
Request
HideShow
Body
[
  {
    "id": "1b900ec4-8628-43ba-88f7-e752085fe6f9",
    "order": 1
  },
  {
    "id": "4c213e89-d4f3-4544-b061-03f32e34847c",
    "order": 2
  }
]
Response  200

Update a lead channel rule

Update a lead channel rule
PUT/brands/:brand/leads/channels/:id/rules/:rule

Example URI

PUT /brands/:brand/leads/channels/:id/rules/:rule
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
channel
string (required) Example: 6cbfb9c5-cd90-4742-bc69-07cc9a335266
rule
string (required) Example: 4c213e89-d4f3-4544-b061-03f32e34847c
associations
string (required) Example: lead_channel_rule.conditions,lead_channel_rule.brand,lead_channel_rule.user
Request
HideShow
Body
{
  "target": "Brand",
  "kind": "OR",
  "order": 2,
  "flow": null,
  "user": null,
  "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
  "conditions": [
    {
      "field": "postal_code",
      "operator": "any",
      "value": [
        "90210",
        "90211"
      ],
      "order": 1
    },
    {
      "field": "price",
      "operator": "lte",
      "value": 1000000,
      "order": 2
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "4c213e89-d4f3-4544-b061-03f32e34847c",
    "created_at": 1778872194.700663,
    "updated_at": 1778872194.700663,
    "deleted_at": null,
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "channel": "6cbfb9c5-cd90-4742-bc69-07cc9a335266",
    "kind": "OR",
    "order": 2,
    "target": "Brand",
    "user": null,
    "brand": {
      "id": "fcb549a4-87d7-46ad-888e-01277dc70110",
      "created_at": 1778872194.773431,
      "updated_at": 1778872194.773431,
      "palette": null,
      "assets": null,
      "messages": null,
      "parent": null,
      "name": "LeadChannel",
      "deleted_at": null,
      "training": false,
      "brand_type": "Team",
      "parents": null,
      "type": "brand",
      "hostnames": null,
      "member_count": 1,
      "base_url": "https://irish.rechat.com"
    },
    "is_default": false,
    "conditions": [
      {
        "id": "03a523c1-2903-4c9a-af24-f580c9e68dfa",
        "created_at": 1778872194.700663,
        "rule": "4c213e89-d4f3-4544-b061-03f32e34847c",
        "order": 1,
        "field": "postal_code",
        "operator": "any",
        "value": [
          "90210",
          "90211"
        ],
        "negated": false,
        "type": "lead_channel_rule_condition"
      },
      {
        "id": "209046d4-d966-4957-a785-1543c91a9b62",
        "created_at": 1778872194.700663,
        "rule": "4c213e89-d4f3-4544-b061-03f32e34847c",
        "order": 2,
        "field": "price",
        "operator": "lte",
        "value": 1000000,
        "negated": false,
        "type": "lead_channel_rule_condition"
      }
    ],
    "type": "lead_channel_rule"
  }
}

Delete a lead channel rule

Delete a lead channel rule
DELETE/brands/:brand/leads/channels/:id/rules/:rule

Example URI

DELETE /brands/:brand/leads/channels/:id/rules/:rule
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
channel
string (required) Example: 6cbfb9c5-cd90-4742-bc69-07cc9a335266
rule
string (required) Example: 4c213e89-d4f3-4544-b061-03f32e34847c
Response  204

Get Lead Routing Groups of brand

Get Lead Routing Groups of brand
GET/brands/:brand/leads/groups

Example URI

GET /brands/:brand/leads/groups
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "38b7a75a-2dc3-49ef-9c80-2f7a27eae89b",
      "created_at": 1778872194.700663,
      "updated_at": 1778872194.700663,
      "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
      "name": "Test Group",
      "description": null,
      "distribution": "RoundRobin",
      "type": "lead_routing_group"
    }
  ],
  "info": {
    "count": 1,
    "total": 0
  }
}

Create a Lead Routing Group

Create a Lead Routing Group
POST/brands/:brand/leads/groups

Example URI

POST /brands/:brand/leads/groups
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
Request
HideShow
Body
{
  "name": "Test Group",
  "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
  "distribution": "RoundRobin",
  "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
  "members": [
    {
      "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "order": 1,
      "brand": "fcb549a4-87d7-46ad-888e-01277dc70110"
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "38b7a75a-2dc3-49ef-9c80-2f7a27eae89b",
    "created_at": 1778872194.700663,
    "updated_at": 1778872194.700663,
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
    "name": "Test Group",
    "description": null,
    "distribution": "RoundRobin",
    "type": "lead_routing_group"
  }
}

Update a Lead Routing Group

Update a Lead Routing Group
PATCH/brands/:brand/leads/groups/:group

Example URI

PATCH /brands/:brand/leads/groups/:group
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
group
string (required) Example: 38b7a75a-2dc3-49ef-9c80-2f7a27eae89b
Request
HideShow
Body
{
  "name": "Test Group Updated",
  "distribution": "FirstToClaim",
  "members": [
    {
      "user": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "order": 2,
      "brand": "fcb549a4-87d7-46ad-888e-01277dc70110"
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "38b7a75a-2dc3-49ef-9c80-2f7a27eae89b",
    "created_at": 1778872194.700663,
    "updated_at": 1778872194.700663,
    "created_by": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
    "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
    "name": "Test Group Updated",
    "description": null,
    "distribution": "FirstToClaim",
    "type": "lead_routing_group"
  }
}

Delete a Lead Routing Group

Delete a Lead Routing Group
DELETE/brands/:brand/leads/groups/:group

Example URI

DELETE /brands/:brand/leads/groups/:group
URI Parameters
HideShow
brand
string (required) Example: fcb549a4-87d7-46ad-888e-01277dc70110
group
string (required) Example: 38b7a75a-2dc3-49ef-9c80-2f7a27eae89b
Response  204

Lead Capture

Overview

Capture a lead using a known lead channel ID

Capture a lead using a known lead channel ID
POST/leads

Example URI

POST /leads
Request
HideShow
Body
{
  "metadata": {
    "lead_channel": "7d8b5d6f-8358-478d-8a48-8c0cb2e45e16"
  },
  "lead": {
    "first_name": "Test",
    "last_name": "User",
    "email": "[email protected]",
    "source_type": "Website"
  }
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "d74b413e-9c2b-4d15-8534-a1d41109cde3",
    "contact": "0b35d7f3-2bde-4321-b8c2-2c955dbcc5f4",
    "lead_channel": "7d8b5d6f-8358-478d-8a48-8c0cb2e45e16",
    "raw_payload": {
      "first_name": "Test",
      "last_name": "User",
      "email": "[email protected]",
      "source_type": "Website"
    },
    "parsed_payload": {
      "first_name": "Test",
      "last_name": "User",
      "email": "[email protected]",
      "source_type": "Website"
    },
    "source_type": "Website",
    "created_at": 1778872184.559
  }
}

Capture a lead using an email campaign email ID

Capture a lead using an email campaign email ID
POST/leads

Example URI

POST /leads
Request
HideShow
Body
{
  "metadata": {
    "email_campaign_email": "d2afdf87-a850-4d9a-9eff-3f324eb2f9f1"
  },
  "lead": {
    "first_name": "Test",
    "last_name": "Recipient",
    "email": "[email protected]",
    "source_type": "Email Campaign"
  }
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "f5e8dbf5-b8fa-4af6-97a9-757696d73efe",
    "contact": "175d0396-8291-4d44-9e32-93648cf8f6cf",
    "lead_channel": "7d8b5d6f-8358-478d-8a48-8c0cb2e45e16",
    "raw_payload": {
      "first_name": "Test",
      "last_name": "Recipient",
      "email": "[email protected]",
      "source_type": "Email Campaign"
    },
    "parsed_payload": {
      "first_name": "Test",
      "last_name": "Recipient",
      "email": "[email protected]",
      "source_type": "Email Campaign"
    },
    "source_type": "Email Campaign",
    "created_at": 1778872188.183
  }
}

Filter contacts by lead channel

Filter contacts by lead channel
POST/contacts/filter

Example URI

POST /contacts/filter
Request
HideShow
Body
{
  "lead_channels": [
    "d936a605-4033-4ccc-97fb-3339b9cb58a9"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "dccdec60-8128-476a-a8f3-e171a54009fe",
      "display_name": "Hossein Derakhshan",
      "partner_name": null,
      "brand": "fcb549a4-87d7-46ad-888e-01277dc70110",
      "brand_id": "fcb549a4-87d7-46ad-888e-01277dc70110",
      "user_id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "sort_field": "Derakhshan Hossein",
      "last_touch": 1778872194.700663,
      "last_touch_action": null,
      "next_touch": null,
      "touch_freq": null,
      "ios_address_book_id": null,
      "android_address_book_id": null,
      "created_at": 1778872196.138494,
      "updated_at": 1778872194.700663,
      "deleted_at": null,
      "created_for": "lts_lead",
      "updated_for": "lts_lead",
      "deleted_for": null,
      "title": null,
      "first_name": "Hossein",
      "partner_first_name": null,
      "middle_name": null,
      "last_name": "Derakhshan",
      "partner_last_name": null,
      "marketing_name": null,
      "nickname": null,
      "email": "[email protected]",
      "primary_email": "[email protected]",
      "emails": [
        "[email protected]"
      ],
      "parked": false,
      "partner_email": null,
      "phone_number": "+905348632070",
      "primary_phone_number": "+905348632070",
      "phone_numbers": [
        "+905348632070"
      ],
      "company": null,
      "birthday": null,
      "profile_image_url": null,
      "cover_image_url": null,
      "job_title": null,
      "source_type": "Showing",
      "source": "Website",
      "website": null,
      "tags": [
        "Showing",
        "Lead"
      ],
      "address": [
        {
          "city": "Atlanta",
          "full": ", Atlanta GA",
          "type": "stdaddr",
          "line2": "Atlanta GA",
          "state": "GA"
        }
      ],
      "type": "contact"
    }
  ],
  "info": {
    "count": 1,
    "total": 1
  }
}

Generated by aglio on 15 May 2026