---
title: "Create a SMTP API token."
method: POST
path: "/marketing/transactional/2026-03/smtp-tokens"
tags: ["SMTP Tokens"]
---

# Create a SMTP API token.

`POST /marketing/transactional/2026-03/smtp-tokens`

Create a SMTP API token.

## Request body

- MarketingTransactionalSmtpApiTokenRequestEgg
  - `campaignName` string, required — A name for the campaign tied to the SMTP API token.
  - `createContact` boolean, required — Indicates whether a contact should be created for email recipients.

## Response `201`

successful operation

- MarketingTransactionalSmtpApiTokenView
  - `campaignName` string, required — A name for the campaign tied to the token.
  - `createContact` boolean, required — Indicates whether a contact should be created for email recipients.
  - `createdAt` string, date-time, required — Timestamp generated when a token is created.
  - `createdBy` string, required — Email address of the user that sent the token creation request.
  - `emailCampaignId` string, required — Identifier assigned to the campaign provided in the token creation request.
  - `id` string, required — User name to log into the HubSpot SMTP server.
  - `password` string — Password used to log into the HubSpot SMTP server.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)
