> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesask.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your API key and make your first request in under five minutes.

## Step 1: Get your API key

You must be an **admin** of your Sales Ask organization.

1. Log in to [integrations.salesask.com](https://integrations.salesask.com)
2. Go to **Settings → Organization**
3. Scroll to the **Organization API Key** section
4. Click the refresh icon to generate a key
5. Copy the key using the copy button next to the field

<Warning>
  Regenerating your key will immediately invalidate any existing integrations using the old key. Store it securely — it grants access to all recordings in your organization.
</Warning>

## Step 2: Fetch your recordings

Pass the key in the `x-api-key` header. The following request returns the 10 most recent processed recordings:

```bash theme={null}
curl "https://integrations.salesask.com/v1/recordings?limit=10" \
  -H "x-api-key: <YOUR_API_KEY>"
```

```json theme={null}
{
  "recordings": [
    {
      "id": "abc123",
      "name": "Call with John Doe",
      "status": "processed",
      "createdAt": "2026-03-01T14:22:00.000Z",
      "duration": 1800000,
      "summary": "Rep discussed pricing and timeline...",
      "recording": "https://integrations.salesask.com/meetings/abc123"
    }
  ],
  "nextCursor": "2026-02-28T09:10:00.000Z",
  "hasMore": true
}
```

## Step 3: Filter by date range

Use `fromDate` and `toDate` to scope results to a specific period:

```bash theme={null}
curl "https://integrations.salesask.com/v1/recordings?fromDate=2026-03-01&toDate=2026-03-31&limit=50" \
  -H "x-api-key: <YOUR_API_KEY>"
```

## Step 4: Paginate

When `hasMore` is `true`, pass `nextCursor` as `startAfter` to fetch the next page:

```bash theme={null}
curl "https://integrations.salesask.com/v1/recordings?startAfter=2026-02-28T09:10:00.000Z" \
  -H "x-api-key: <YOUR_API_KEY>"
```

## Next steps

<CardGroup cols={2}>
  <Card title="Push appointments" href="/guides/scheduled-tasks" icon="calendar">
    Send upcoming appointment data so Sales Ask can associate recordings with your CRM jobs.
  </Card>

  <Card title="Subscribe to webhooks" href="/guides/webhooks" icon="webhook">
    Get notified automatically when a recording finishes processing.
  </Card>
</CardGroup>