---
title: "Query a single token by ID."
method: GET
path: "/marketing/transactional/2026-09/smtp-tokens/{tokenId}"
tags: ["SMTP Tokens"]
---

# Query a single token by ID.

`GET /marketing/transactional/2026-09/smtp-tokens/{tokenId}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/transactional/2026-09/smtp-tokens/{tokenId}`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `transactional-email`

Query a single token by ID.

## Path parameters

- `tokenId` string, required

## Response `200`

successful operation

- SmtpApiTokenView
  - `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.

## Changes

- **2026-09-03** (2026-09) `a04185df14f9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/marketing-transactional-single-send/changes/marketing/transactional/2026-09/smtp-tokens/:tokenId/get.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-transactional-single-send.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-transactional-single-send/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-transactional-single-send/revisions/c1f17c6e69d3?raw)