Skip to main content
POST
Ask a research question about a contact

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Path Parameters

contactID
string
required

Tamtam contact ID.

Example:

"b3c6f5e2-1234-4abc-9def-0123456789ab"

Body

application/json
question
string
required

The question to answer about this contact, in plain language. Grounded in the person's profile, their company, and a web search.

Required string length: 3 - 2000
Example:

"Which brands does this person look after?"

name
string

Short label for the question, as a CRM column name would be. Defaults to the question text.

Example:

"Brands managed"

Response

Accepted

id
string
required

ID of the question. Stable across contacts: the same question asked about ten people carries one ID.

Example:

"b3c6f5e2-1234-4abc-9def-0123456789ab"

name
string
required

The column name given to this question.

Example:

"Brands managed"

question
string
required

The question as configured.

Example:

"Which brands does this person look after?"

status
string
required

One of COMPLETED, PROCESSING, FAILED.

Example:

"COMPLETED"

answer
string

The answer, present once the status is COMPLETED.

updated_at
string<date-time>

When this question last produced an answer for this contact.