Retrieve Leads
Retrieve a paginated list of leads. Optionally filter by domain.
query Parameters
domainstringFilter leads by domain.
pageintegerPage number.
Default: 1limitintegerNumber of leads per page.
Default: 10
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
A list of leads.
dataobject[]metaobject
Retrieve a Single Lead
Retrieve detailed information for a specific lead.
path Parameters
leadIdstring · requiredThe ID of the lead.
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
A lead object.
idstring · requiredemailstring · required
firstNamestringlastNamestringcompanystringtitlestringattributesobject[]
Update a lead
Update the fields of a lead using id.
path Parameters
leadIdstring · requiredThe ID of the lead.
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
A lead object.
idstring · requiredemailstring · required
firstNamestringlastNamestringcompanystringtitlestringattributesobject[]
Delete a lead
Delete a lead using id.
path Parameters
leadIdstring · requiredThe ID of the lead.
Headers
X-Tomba-Keystring · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEYX-Tomba-Secretstring · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Responses
a pet to be returned
dataobject