Tomba

Lead Lists

Endpointhttps://api.tomba.io/v1

Retrieve Leads Lists

GET

https://api.tomba.io/v1

/leads_lists

Retrieve a list of leads lists.

Retrieve Leads Lists › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve Leads Lists › Responses

200

A list of leads lists.

object[]

GET/leads_lists

curl --request GET \
  --url https://api.tomba.io/v1/leads_lists \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "data": [
    {
      "id": "id",
      "name": "name",
      "description": "description",
      "leads": [
        {
          "id": "id",
          "email": "email",
          "firstName": "firstName",
          "lastName": "lastName",
          "company": "company",
          "title": "title",
          "attributes": [
            {
              "id": "id",
              "name": "name",
              "value": "value"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Create Leads List

POST

https://api.tomba.io/v1

/leads_lists

Create a new leads list.

Create Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create Leads List › Request Body

id

string · required

name

string · required

description

string

object[]

Create Leads List › Responses

Leads list created successfully.

id

string · required

name

string · required

description

string

object[]

POST/leads_lists

curl --request POST \
  --url https://api.tomba.io/v1/leads_lists \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx' \
  --data '
{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}
'

shell

Example Request Body

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

application/json

Retrieve a Single Leads List

GET

https://api.tomba.io/v1

/leads_lists/{listId}

Retrieve details of a specific leads list.

Retrieve a Single Leads List › path Parameters

listId

string · required

The ID of the leads list.

Retrieve a Single Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve a Single Leads List › Responses

A leads list object.

id

string · required

name

string · required

description

string

object[]

GET/leads_lists/{listId}

curl --request GET \
  --url https://api.tomba.io/v1/leads_lists/:listId \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

application/json

Update Leads List

PUT

https://api.tomba.io/v1

/leads_lists/{listId}

Update a specific leads list.

Update Leads List › path Parameters

listId

string · required

The ID of the leads list.

Update Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Update Leads List › Request Body

id

string · required

name

string · required

description

string

object[]

Update Leads List › Responses

200

Leads list updated successfully.

id

string · required

name

string · required

description

string

object[]

PUT/leads_lists/{listId}

curl --request PUT \
  --url https://api.tomba.io/v1/leads_lists/:listId \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx' \
  --data '
{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}
'

shell

Example Request Body

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

application/json

Delete Leads List

DELETE

https://api.tomba.io/v1

/leads_lists/{listId}

Delete a specific leads list.

Delete Leads List › path Parameters

listId

string · required

The ID of the leads list.

Delete Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete Leads List › Responses

Leads list deleted successfully.

No data returned

DELETE/leads_lists/{listId}

curl --request DELETE \
  --url https://api.tomba.io/v1/leads_lists/:listId \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

No example specified for this content type

Lead Attributes Keys

Tomba

Lead Lists

Endpointhttps://api.tomba.io/v1

Retrieve Leads Lists

GET

https://api.tomba.io/v1

/leads_lists

Retrieve a list of leads lists.

Retrieve Leads Lists › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve Leads Lists › Responses

200

A list of leads lists.

object[]

GET/leads_lists

curl --request GET \
  --url https://api.tomba.io/v1/leads_lists \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "data": [
    {
      "id": "id",
      "name": "name",
      "description": "description",
      "leads": [
        {
          "id": "id",
          "email": "email",
          "firstName": "firstName",
          "lastName": "lastName",
          "company": "company",
          "title": "title",
          "attributes": [
            {
              "id": "id",
              "name": "name",
              "value": "value"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Create Leads List

POST

https://api.tomba.io/v1

/leads_lists

Create a new leads list.

Create Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Create Leads List › Request Body

id

string · required

name

string · required

description

string

object[]

Create Leads List › Responses

Leads list created successfully.

id

string · required

name

string · required

description

string

object[]

POST/leads_lists

curl --request POST \
  --url https://api.tomba.io/v1/leads_lists \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx' \
  --data '
{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}
'

shell

Example Request Body

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

application/json

Retrieve a Single Leads List

GET

https://api.tomba.io/v1

/leads_lists/{listId}

Retrieve details of a specific leads list.

Retrieve a Single Leads List › path Parameters

listId

string · required

The ID of the leads list.

Retrieve a Single Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve a Single Leads List › Responses

A leads list object.

id

string · required

name

string · required

description

string

object[]

GET/leads_lists/{listId}

curl --request GET \
  --url https://api.tomba.io/v1/leads_lists/:listId \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

application/json

Update Leads List

PUT

https://api.tomba.io/v1

/leads_lists/{listId}

Update a specific leads list.

Update Leads List › path Parameters

listId

string · required

The ID of the leads list.

Update Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Update Leads List › Request Body

id

string · required

name

string · required

description

string

object[]

Update Leads List › Responses

200

Leads list updated successfully.

id

string · required

name

string · required

description

string

object[]

PUT/leads_lists/{listId}

curl --request PUT \
  --url https://api.tomba.io/v1/leads_lists/:listId \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx' \
  --data '
{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}
'

shell

Example Request Body

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

Example Responses

{
  "id": "id",
  "name": "name",
  "description": "description",
  "leads": [
    {
      "id": "id",
      "email": "email",
      "firstName": "firstName",
      "lastName": "lastName",
      "company": "company",
      "title": "title",
      "attributes": [
        {
          "id": "id",
          "name": "name",
          "value": "value"
        }
      ]
    }
  ]
}

json

application/json

Delete Leads List

DELETE

https://api.tomba.io/v1

/leads_lists/{listId}

Delete a specific leads list.

Delete Leads List › path Parameters

listId

string · required

The ID of the leads list.

Delete Leads List › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Delete Leads List › Responses

Leads list deleted successfully.

No data returned

DELETE/leads_lists/{listId}

curl --request DELETE \
  --url https://api.tomba.io/v1/leads_lists/:listId \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

No example specified for this content type

Lead Attributes Keys