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

# Postman collections

> Import Sendmux API collections into Postman and configure your API key.

Use the Sendmux Postman collections to try requests, save examples, and share API workflows with your team.

Prefer Postman's web app? Open the <a href="https://www.postman.com/sendmux/workspace/sendmux-email-inbox-api-sending" rel="nofollow noopener noreferrer" target="_blank">published Sendmux collection</a>, then fork it into your workspace.

<Info>
  You need a Sendmux API key before sending authenticated requests. Create one
  in the Sendmux app under **API Keys**.
</Info>

## Choose a collection

| Collection     | Use it for                                                       | Run in Postman                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Management API | Manage sending accounts, domains, mailboxes, webhooks, and logs. | <a href="https://god.gw.postman.com/run-collection/2607731-3f234e9b-f322-46fe-8ea2-3f3c2e6ce3b3?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D2607731-3f234e9b-f322-46fe-8ea2-3f3c2e6ce3b3%26entityType%3Dcollection%26workspaceId%3Df4e271d9-e749-4386-b2ca-bee78917b3d1" rel="nofollow noopener noreferrer" target="_blank"><img src="https://run.pstmn.io/button.svg" alt="Run in Postman" /></a> |
| Mailbox API    | Read and manage one mailbox using a mailbox-scoped credential.   | <a href="https://god.gw.postman.com/run-collection/2607731-8365c261-1af1-47c6-815c-e80a13932b28?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D2607731-8365c261-1af1-47c6-815c-e80a13932b28%26entityType%3Dcollection%26workspaceId%3Df4e271d9-e749-4386-b2ca-bee78917b3d1" rel="nofollow noopener noreferrer" target="_blank"><img src="https://run.pstmn.io/button.svg" alt="Run in Postman" /></a> |
| Sending API    | Send single or batch emails through the Sending API.             | <a href="https://god.gw.postman.com/run-collection/2607731-735e7ae4-2652-4ab0-a3d2-f4ae9fd5cc55?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D2607731-735e7ae4-2652-4ab0-a3d2-f4ae9fd5cc55%26entityType%3Dcollection%26workspaceId%3Df4e271d9-e749-4386-b2ca-bee78917b3d1" rel="nofollow noopener noreferrer" target="_blank"><img src="https://run.pstmn.io/button.svg" alt="Run in Postman" /></a> |

## Import by URL

<Steps>
  <Step title="Open import">
    In Postman, select **Import**, then choose **Link**.
  </Step>

  <Step title="Paste the collection URL">
    Paste the URL for the collection you want to use, then select **Continue**.
  </Step>

  <Step title="Confirm the import">
    Review the collection name, then select **Import**.
  </Step>
</Steps>

### Collection import URLs

| Collection     | Import URL                                                                                                                                                |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Management API | [https://sendmux.ai/docs/postman/sendmux-management.postman\_collection.json](https://sendmux.ai/docs/postman/sendmux-management.postman_collection.json) |
| Mailbox API    | [https://sendmux.ai/docs/postman/sendmux-mailbox.postman\_collection.json](https://sendmux.ai/docs/postman/sendmux-mailbox.postman_collection.json)       |
| Sending API    | [https://sendmux.ai/docs/postman/sendmux-sending.postman\_collection.json](https://sendmux.ai/docs/postman/sendmux-sending.postman_collection.json)       |

## Configure authentication

Each collection uses a `sendmux_api_key` collection variable.

<Steps>
  <Step title="Open collection variables">
    In Postman, open the imported collection, then select **Variables**.
  </Step>

  <Step title="Set the API key">
    Set `sendmux_api_key` to your `smx_` API key.
  </Step>

  <Step title="Save changes">Select **Save** before running requests.</Step>
</Steps>

<Warning>
  Do not commit, publish, or share a collection after adding a real API key.
</Warning>

## Base URL variables

The collections include these base URL variables:

| Collection     | Variable              | Default value                    |
| -------------- | --------------------- | -------------------------------- |
| Management API | `management_base_url` | `https://app.sendmux.ai/api/v1`  |
| Mailbox API    | `mailbox_base_url`    | `https://app.sendmux.ai/api/v1`  |
| Sending API    | `sending_base_url`    | `https://smtp.sendmux.ai/api/v1` |

Change a base URL only if Sendmux support asks you to use a different endpoint.

## Update a collection

Re-import the same URL when you want the latest requests. The collection files use the same API descriptions as the Sendmux reference docs.

## Next steps

<Columns cols={2}>
  <Card title="Management API" icon="settings" href="/docs/api/introduction">
    Read authentication, permissions, response formats, and rate limits.
  </Card>

  <Card title="Mailbox API" icon="inbox" href="/docs/mailbox-api/introduction">
    Use a mailbox-scoped credential for one mailbox.
  </Card>

  <Card title="Sending API" icon="send" href="/docs/sending-api/introduction">
    Send email through the HTTP API.
  </Card>

  <Card title="API keys" icon="key" href="/docs/guides/api-keys">
    Create scoped keys for applications and integrations.
  </Card>
</Columns>