Welcome to Tomba Docs! Create a free Tomba account and gain instant access to 400+ million contacts!
Tomba

Lead Lists

Endpoint:https://api.tomba.io/v1

Retrieve Leads Lists

GET
https://api.tomba.io/v1
/leads_lists

Retrieve a list of leads lists.

Retrieve Leads ListsHeaders

  • X-Tomba-Keystring · required

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

  • X-Tomba-Secretstring · required

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

Retrieve Leads Lists Responses

A list of leads lists.

  • dataobject[]

Create Leads List

POST
https://api.tomba.io/v1
/leads_lists

Create a new leads list.

Create Leads ListHeaders

  • X-Tomba-Keystring · required

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

  • X-Tomba-Secretstring · required

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

Create Leads List Request Body

  • idstring · required
  • namestring · required
  • descriptionstring
  • leadsobject[]

Create Leads List Responses

Leads list created successfully.

  • idstring · required
  • namestring · required
  • descriptionstring
  • leadsobject[]

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 Listpath Parameters

  • listIdstring · required

    The ID of the leads list.

Retrieve a Single Leads ListHeaders

  • X-Tomba-Keystring · required

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

  • X-Tomba-Secretstring · required

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

Retrieve a Single Leads List Responses

A leads list object.

  • idstring · required
  • namestring · required
  • descriptionstring
  • leadsobject[]

Update Leads List

PUT
https://api.tomba.io/v1
/leads_lists/{listId}

Update a specific leads list.

Update Leads Listpath Parameters

  • listIdstring · required

    The ID of the leads list.

Update Leads ListHeaders

  • X-Tomba-Keystring · required

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

  • X-Tomba-Secretstring · required

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

Update Leads List Request Body

  • idstring · required
  • namestring · required
  • descriptionstring
  • leadsobject[]

Update Leads List Responses

Leads list updated successfully.

  • idstring · required
  • namestring · required
  • descriptionstring
  • leadsobject[]

Delete Leads List

DELETE
https://api.tomba.io/v1
/leads_lists/{listId}

Delete a specific leads list.

Delete Leads Listpath Parameters

  • listIdstring · required

    The ID of the leads list.

Delete Leads ListHeaders

  • X-Tomba-Keystring · required

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

  • X-Tomba-Secretstring · required

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

Delete Leads List Responses

Leads list deleted successfully.

No data returned