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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "e86cad72-67e4-4dd5-9066-4589c69e9ce1",
      "name": "Default Route",
      "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
      "capture_number": 0,
      "mls": null,
      "is_default": true,
      "type": "lead_channel",
      "created_at": 1787792087.768487,
      "updated_at": 1787792087.768489,
      "deleted_at": null,
      "last_capture_date": null,
      "rules_count": "1"
    },
    {
      "id": "dec38e2d-3afe-41c5-8cfa-b451634a6b38",
      "name": null,
      "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
      "capture_number": 0,
      "mls": null,
      "is_default": false,
      "type": "lead_channel",
      "created_at": 1787792087.836151,
      "updated_at": 1787792087.836152,
      "deleted_at": null,
      "last_capture_date": null,
      "rules_count": "1"
    }
  ],
  "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
Request
HideShow
Body
{
  "protocol": "JSON"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "dec38e2d-3afe-41c5-8cfa-b451634a6b38",
    "name": null,
    "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
    "capture_number": 0,
    "mls": null,
    "is_default": false,
    "type": "lead_channel",
    "created_at": 1787792087.836151,
    "updated_at": 1787792087.836152,
    "deleted_at": null,
    "last_capture_date": null,
    "rules_count": "1"
  }
}

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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
channel
string (required) Example: dec38e2d-3afe-41c5-8cfa-b451634a6b38
Request
HideShow
Body
{
  "brand": "0278a429-77dd-4d4d-8ff4-805a1817d65f"
}
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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
channel
string (required) Example: dec38e2d-3afe-41c5-8cfa-b451634a6b38
Request
HideShow
Body
{
  "name": "New Name"
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "dec38e2d-3afe-41c5-8cfa-b451634a6b38",
    "name": "New Name",
    "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
    "capture_number": 0,
    "mls": null,
    "is_default": false,
    "type": "lead_channel",
    "created_at": 1787792087.836151,
    "updated_at": 1787792087.106755,
    "deleted_at": null,
    "last_capture_date": null,
    "rules_count": "1"
  }
}

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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
channel
string (required) Example: dec38e2d-3afe-41c5-8cfa-b451634a6b38
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": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
  "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
  "conditions": [
    {
      "field": "price",
      "operator": "gte",
      "value": 500000,
      "order": 1
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "998827a1-0df5-4056-8179-7b9febae7c9a",
    "created_at": 1787792087.106755,
    "updated_at": 1787792087.106755,
    "deleted_at": null,
    "created_by": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
    "channel": "dec38e2d-3afe-41c5-8cfa-b451634a6b38",
    "kind": "AND",
    "order": 1,
    "target": "User",
    "user": {
      "type": "user",
      "username": null,
      "first_name": "John",
      "last_name": "Doe",
      "email": "test-lead_channel-a762e7b3-665e-41ae-b7b4-3ed98b33eb9a@rechat.com",
      "phone_number": "+14487088138",
      "created_at": 1787792087.126529,
      "id": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1787792087.126553,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": false,
      "timezone": "America/Chicago",
      "user_type": "Agent",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": null,
      "personal_room": "348bc674-a97b-415a-88d2-8c264553e29a",
      "brand": null,
      "fake_email": null,
      "features": null,
      "last_seen_at": null,
      "email_signature": "This is my signature.",
      "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": null,
      "bio": "This is my bio.",
      "current_time": "7:54 PM - Wednesday Aug 26, 2026",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": "0278a429-77dd-4d4d-8ff4-805a1817d65f",
      "display_name": "John Doe",
      "abbreviated_display_name": "John",
      "online_state": "Offline",
      "has_password": true
    },
    "brand": {
      "id": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
      "created_at": 1787792087.272993,
      "updated_at": 1787792087.272993,
      "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": "773a5058-ba9c-40e7-9440-e596b54fabe8",
        "created_at": 1787792087.106755,
        "rule": "998827a1-0df5-4056-8179-7b9febae7c9a",
        "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
channel
string (required) Example: dec38e2d-3afe-41c5-8cfa-b451634a6b38
associations
string (required) Example: lead_channel_rule.conditions,lead_channel_rule.brand,lead_channel_rule.user
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "998827a1-0df5-4056-8179-7b9febae7c9a",
      "created_at": 1787792087.106755,
      "updated_at": 1787792087.106755,
      "deleted_at": null,
      "created_by": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
      "channel": "dec38e2d-3afe-41c5-8cfa-b451634a6b38",
      "kind": "AND",
      "order": 1,
      "target": "User",
      "user": {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "test-lead_channel-a762e7b3-665e-41ae-b7b4-3ed98b33eb9a@rechat.com",
        "phone_number": "+14487088138",
        "created_at": 1787792087.126529,
        "id": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1787792087.126553,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Agent",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "348bc674-a97b-415a-88d2-8c264553e29a",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "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": null,
        "bio": "This is my bio.",
        "current_time": "7:54 PM - Wednesday Aug 26, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": "0278a429-77dd-4d4d-8ff4-805a1817d65f",
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      },
      "brand": {
        "id": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
        "created_at": 1787792087.272993,
        "updated_at": 1787792087.272993,
        "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": "773a5058-ba9c-40e7-9440-e596b54fabe8",
          "created_at": 1787792087.106755,
          "rule": "998827a1-0df5-4056-8179-7b9febae7c9a",
          "order": 1,
          "field": "price",
          "operator": "gte",
          "value": 500000,
          "negated": false,
          "type": "lead_channel_rule_condition"
        }
      ],
      "type": "lead_channel_rule"
    },
    {
      "id": "24108406-9268-44d2-bd44-e44a9b4b0235",
      "created_at": 1787792087.106755,
      "updated_at": 1787792087.106755,
      "deleted_at": null,
      "created_by": null,
      "channel": "dec38e2d-3afe-41c5-8cfa-b451634a6b38",
      "kind": "AND",
      "order": 32767,
      "target": "User",
      "user": {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "test-lead_channel-a762e7b3-665e-41ae-b7b4-3ed98b33eb9a@rechat.com",
        "phone_number": "+14487088138",
        "created_at": 1787792087.126529,
        "id": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1787792087.126553,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Agent",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "348bc674-a97b-415a-88d2-8c264553e29a",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "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": null,
        "bio": "This is my bio.",
        "current_time": "7:54 PM - Wednesday Aug 26, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": "0278a429-77dd-4d4d-8ff4-805a1817d65f",
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      },
      "brand": {
        "id": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
        "created_at": 1787792087.272993,
        "updated_at": 1787792087.272993,
        "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
channel
string (required) Example: dec38e2d-3afe-41c5-8cfa-b451634a6b38
Request
HideShow
Body
[
  {
    "id": "24108406-9268-44d2-bd44-e44a9b4b0235",
    "order": 1
  },
  {
    "id": "998827a1-0df5-4056-8179-7b9febae7c9a",
    "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
channel
string (required) Example: dec38e2d-3afe-41c5-8cfa-b451634a6b38
rule
string (required) Example: 998827a1-0df5-4056-8179-7b9febae7c9a
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": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
  "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": "998827a1-0df5-4056-8179-7b9febae7c9a",
    "created_at": 1787792087.106755,
    "updated_at": 1787792087.106755,
    "deleted_at": null,
    "created_by": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
    "channel": "dec38e2d-3afe-41c5-8cfa-b451634a6b38",
    "kind": "OR",
    "order": 2,
    "target": "Brand",
    "user": null,
    "brand": {
      "id": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
      "created_at": 1787792087.272993,
      "updated_at": 1787792087.272993,
      "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": "7f30993d-e555-411b-a5ab-85b830c84ac0",
        "created_at": 1787792087.106755,
        "rule": "998827a1-0df5-4056-8179-7b9febae7c9a",
        "order": 1,
        "field": "postal_code",
        "operator": "any",
        "value": [
          "90210",
          "90211"
        ],
        "negated": false,
        "type": "lead_channel_rule_condition"
      },
      {
        "id": "f50fc05b-6114-41ea-a0d7-50e2c90c297a",
        "created_at": 1787792087.106755,
        "rule": "998827a1-0df5-4056-8179-7b9febae7c9a",
        "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
channel
string (required) Example: dec38e2d-3afe-41c5-8cfa-b451634a6b38
rule
string (required) Example: 998827a1-0df5-4056-8179-7b9febae7c9a
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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "b3cb5fd9-73f9-487e-84f5-ed250eb8962d",
      "created_at": 1787792087.106755,
      "updated_at": 1787792087.106755,
      "created_by": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
      "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
      "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
Request
HideShow
Body
{
  "name": "Test Group",
  "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
  "distribution": "RoundRobin",
  "created_by": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
  "members": [
    {
      "user": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
      "order": 1,
      "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af"
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "b3cb5fd9-73f9-487e-84f5-ed250eb8962d",
    "created_at": 1787792087.106755,
    "updated_at": 1787792087.106755,
    "created_by": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
    "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
    "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
group
string (required) Example: b3cb5fd9-73f9-487e-84f5-ed250eb8962d
Request
HideShow
Body
{
  "name": "Test Group Updated",
  "distribution": "FirstToClaim",
  "members": [
    {
      "user": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
      "order": 2,
      "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af"
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "b3cb5fd9-73f9-487e-84f5-ed250eb8962d",
    "created_at": 1787792087.106755,
    "updated_at": 1787792087.106755,
    "created_by": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
    "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
    "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: 472bc90d-40b1-4975-b3cd-c2de006ae6af
group
string (required) Example: b3cb5fd9-73f9-487e-84f5-ed250eb8962d
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": "f8da36da-7346-485b-a7c3-40a31b5da52a"
  },
  "lead": {
    "first_name": "Test",
    "last_name": "User",
    "email": "[email protected]",
    "source_type": "Website"
  }
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "5a312b5f-15de-4c9b-ac7a-777720aa9fac",
    "contact": "6f3497af-5c83-4efb-99aa-82c93e2f507d",
    "lead_channel": "f8da36da-7346-485b-a7c3-40a31b5da52a",
    "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": 1787792076.32
  }
}

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": "c4c685c0-11bc-40c9-b592-63289a3eecd2"
  },
  "lead": {
    "first_name": "Test",
    "last_name": "Recipient",
    "email": "[email protected]",
    "source_type": "Email Campaign"
  }
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "id": "7b6691b5-0a02-46b5-9390-6eb29c477b07",
    "contact": "b1e57d2d-c8a3-4651-a60e-9afa82bd11a3",
    "lead_channel": "f8da36da-7346-485b-a7c3-40a31b5da52a",
    "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": 1787792079.848
  }
}

Filter contacts by lead channel

Filter contacts by lead channel
POST/contacts/filter

Example URI

POST /contacts/filter
Request
HideShow
Body
{
  "lead_channels": [
    "f104e993-be3b-49d2-9795-28e4aab1fe3a"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "id": "b9b0b37c-2962-4659-b0df-ce3d5ce79405",
      "display_name": "Hossein Derakhshan",
      "partner_name": null,
      "brand": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
      "brand_id": "472bc90d-40b1-4975-b3cd-c2de006ae6af",
      "user_id": "a1793c89-2f9a-4a92-9b84-8f0ed1ca9005",
      "sort_field": "Derakhshan Hossein",
      "last_touch": 1787792087.106755,
      "last_touch_action": null,
      "next_touch": null,
      "touch_freq": null,
      "ios_address_book_id": null,
      "android_address_book_id": null,
      "created_at": 1787792088.427007,
      "updated_at": 1787792087.106755,
      "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": "940 727-9540",
      "primary_phone_number": "940 727-9540",
      "phone_numbers": [
        "940 727-9540"
      ],
      "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 27 Aug 2026