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

# Rest API

> Connect any system to Smart Send using our Rest API.

## Use the Smart Send API

You can use the Smart Send REST API to create shipping labels and manage shipments from any external system. All official Smart Send integrations use this same API, ensuring reliability and consistency across platforms.

The API is suitable for custom integrations, automation, or connecting third-party systems to Smart Send.

<Card title="API Specification" icon="file-code" href="/api-reference/agents/list-carrier-agents-in-country" arrow="true" horizontal>
  See our OpenAPI specification
</Card>

## Authentication

All requests to the Smart Send API require authentication using an API token. The token must be included in the `Authorization` header as a Bearer token.

### Creating an API Token

To create an API token, start by logging into the <Link href="https://app.smartsend.io">Smart Send platform</Link> <Icon icon="arrow-up-right" size={12} />.

<Steps>
  <Step title="Navigate to API Tokens">
    Go to **<Link href="https://app.smartsend.io/api-tokens">API Tokens</Link>**
  </Step>

  <Step title="Create token">
    In the section **Create API Token** fill in a name which is only used for your internal classification

    <img src="https://mintcdn.com/smartsend/oG0vUhSrEWp3SfSv/images/api-tokens/sanctum-create.png?fit=max&auto=format&n=oG0vUhSrEWp3SfSv&q=85&s=d1c7df8960fd6ceabf8d67ecf6120e4e" alt="Create API Token form with token name field" className="rounded-lg" width="1440" height="900" data-path="images/api-tokens/sanctum-create.png" />
  </Step>

  <Step title="Generate token">
    Click the **Create** button which will open a modal displaying the newly generated *API Token*

    <img src="https://mintcdn.com/smartsend/oG0vUhSrEWp3SfSv/images/api-tokens/sanctum-created.png?fit=max&auto=format&n=oG0vUhSrEWp3SfSv&q=85&s=294eb5f668ff58b38c85a9c55df5d331" alt="Modal displaying the newly generated API token" className="rounded-lg" width="1440" height="900" data-path="images/api-tokens/sanctum-created.png" />
  </Step>
</Steps>

<Note>
  Note that for security reasons then the API Token is only shown once. You can always delete it and create a new one if need be.
</Note>

### Revoking an API Token

To revoke an API token, start by logging into the <Link href="https://app.smartsend.io">Smart Send platform</Link> <Icon icon="arrow-up-right" size={12} />.

<Steps>
  <Step title="Navigate to API Tokens">
    Go to **<Link href="https://app.smartsend.io/api-tokens">API Tokens</Link>**
  </Step>

  <Step title="Find the token">
    In the section **Manage API Tokens** find the API Token you want to delete

    <img src="https://mintcdn.com/smartsend/oG0vUhSrEWp3SfSv/images/api-tokens/sanctum-token-list.png?fit=max&auto=format&n=oG0vUhSrEWp3SfSv&q=85&s=c05daa558a0939d3a5495d1cdbd5593d" alt="List of API tokens with delete option" className="rounded-lg" width="1440" height="900" data-path="images/api-tokens/sanctum-token-list.png" />
  </Step>

  <Step title="Delete the token">
    Click the **Delete** button next to the API Token you want to delete and confirm the action

    <img src="https://mintcdn.com/smartsend/oG0vUhSrEWp3SfSv/images/api-tokens/sanctum-delete-confirmation.png?fit=max&auto=format&n=oG0vUhSrEWp3SfSv&q=85&s=27925081cb98111a0a4f2062691f7b6a" alt="Confirmation dialog for deleting an API token" className="rounded-lg" width="1440" height="900" data-path="images/api-tokens/sanctum-delete-confirmation.png" />
  </Step>
</Steps>

<Warning>
  Deleting an API Token is irreversible and can break any integrations that is using that API Token.
</Warning>
