Leads
Supported lead attributes:
Attribute | Type | Description |
---|---|---|
id |
number | Unique identifier of the lead. |
creator_id |
number | Unique identifier of the user who created the lead. |
owner_id |
number | Unique identifier of the user who currently owns the lead. |
first_name |
string | First name of the lead. |
last_name |
string | Last name of the lead. Required unless organization_name field is provided. |
organization_name |
string | Organization name of the lead. Required unless last_name field is provided. |
status |
string | Status of the lead. |
source_id |
number | Unique identifier of the Source. |
title |
string | Job title of the lead. |
description |
string | The lead's description. |
industry |
string | Organization's industry. |
website |
string | The lead's website address. |
email |
string | The lead's email address. |
phone |
string | The lead's phone number. |
mobile |
string | The lead's mobile phone number. |
fax |
string | The lead's fax number. |
twitter |
string | The lead's Twitter handle. |
facebook |
string | The lead's Facebook nickname. |
linkedin |
string | The lead's Linkedin nickname. |
skype |
string | The lead's Skype nickname. |
address |
Address | The lead's address. For more information about the address object see Address |
tags |
array | An array of tags for a lead. See more at Tag. |
custom_field_values |
array | An array of custom field values for a lead. See more at Custom Field Value. |
created_at |
string | Date and time that the lead was created in UTC (ISO8601 format). |
Endpoints
Stream Leads
Read the stream of lead events.
See the Firehose Overview article for more details on request and response formats and parameters.
Action
GET /v3/leads/stream
Examples
Read the stream of lead events
GET /v3/leads/stream?position=tail
Accept: application/json
Authorization: Bearer $ACCESS_TOKEN
User-Agent: $CLIENT_NAME
HTTP/1.1 200 OK
Content-Type: application/json
{
"items": [
{
"data": {
"id": 4255984,
"creator_id": 190756,
"owner_id": 190756,
"first_name": "ABC",
"last_name": "XYZ",
"organization_name": null,
"status": "New",
"source_id": 134455,
"title": "CEO",
"description": null,
"industry": null,
"website": null,
"email": null,
"phone": "1234-5677",
"mobile": null,
"fax": null,
"twitter": null,
"facebook": null,
"linkedin": null,
"skype": null,
"address": {
"country": "Poland",
"city": "KRK",
"state": "",
"postal_code": "",
"line1": "street 123"
},
"tags": [
{
"data": {
"name": "ABC",
"resource_type": "lead",
"id": 512665
},
"meta": {
"type": "tag"
}
}
],
"custom_field_values": [
{
"value": false,
"custom_field": {
"data": {
"name": "myField",
"resource_type": "lead",
"id": 29609,
"type": "bool"
},
"meta": {
"type": "custom_field"
}
}
}
],
"created_at": "2016-03-15T09:13:06Z"
},
"meta": {
"event_id": "XqEROfOwTCucD-qjE1cO6w",
"event_cause": "interaction",
"sequence": 1,
"event_type": "updated",
"previous": {
"title": "123"
},
"type": "lead",
"event_time": "2016-08-18T07:29:42Z"
}
}
],
"meta": {
"links": {
"next": "https://api.getbase.com/v3/leads/stream?position=ZmlyZWhvc2UuZmFjdG9pZC5jb250YWN0LnNuYXBzaG90cywxLDMwNTQ5Mg=="
},
"position": "ZmlyZWhvc2UuZmFjdG9pZC5jb250YWN0LnNuYXBzaG90cywxLDMwNTQ5Mg==",
"top": false
}
}