Skip to main content
Every request to the Sales Ask API uses your organization API key. The key is scoped to your organization, so every response only includes your organization’s data.

​
Create your API key

1

Open organization settings

As an organization admin, log in to Sales Ask and go to Settings → Organization.
2

Generate the key

In the Organization API Key section, click the refresh icon.
3

Copy it somewhere safe

Copy the key with the button next to the field, and store it in your secrets manager.
Regenerating the key immediately invalidates the old one, everywhere it’s used: API calls, dialer webhook URLs, and the check your webhook endpoint does on incoming requests. Store the key securely. It gives access to every recording in your organization.

​
Send the key

Pass the key in the x-api-key header on every request:
Authorization: Bearer <YOUR_API_KEY> also works. Keys in query parameters aren’t accepted. A missing or wrong key returns 401 with { "message": "Invalid Api Key" }.

​
Base URL

All endpoints are under /v1.

​
Try a request

This request returns your 10 most recent processed recordings:

​
Filter and paginate

Use fromDate and toDate to limit results to a date range:
When hasMore is true, pass nextCursor as startAfter to get the next page:

​
Responses and errors

All endpoints return JSON. Successful responses have a top-level key named after the resource, such as recordings or appointment. Errors return an HTTP status code and a JSON body with a message. Validation errors for a missing field also include code and field, which tell you what to fix:

​
Timestamps

Timestamps are ISO 8601 strings in UTC, for example 2026-03-01T14:22:00.000Z. Times you send must also be UTC. Durations, such as duration and avgDurationMs, are in milliseconds.

Connect your CRM

Keep appointments in sync and get recording results back by webhook.

Connect your phone system

Send finished calls from any dialer to Sales Ask.
Questions about the API? Email support@salesask.com. Never include your API key.