Channel Connect

Get Token

Get details of a specific channel connect token.

Required Scopes: channels:read

Note: The raw token value is NOT included - it was only shown at creation.

get/api/v1/channel-connect-tokens/{token_id}

Request

  • Base URL: https://api.sendseven.com
  • URL: https://api.sendseven.com/api/v1/channel-connect-tokens/{token_id}
  • Auth: HTTP bearer

Path parameters

token_idstring required

Response

Successful Response

idstring required

Unique identifier (UUID)

namestring nullable

Token name

token_prefixstring required

Token prefix for display (e.g., 's7_cc_abc12345')

allowed_channel_typesstring[]

Allowed channel types

allowed_channel_modesobject nullable

Per-channel connect-mode restrictions as authored by the admin. Null (or an absent channel key) means all modes are allowed for that channel.

partner_namestring nullable

Partner name

partner_redirect_urlstring nullable

Redirect URL after connection

connect_urlstring nullable

Full connect URL for sharing

max_usesinteger required

Maximum allowed uses

current_usesinteger required

Current number of successful connections

use_window_minutesinteger required

Grace period after first use

first_used_atstring nullable

When token was first used

expires_atstring required

Token expiration time

is_revokedboolean required

Whether token was manually revoked

is_lockedboolean required

Whether token was locked due to failures

is_validboolean required

Whether token is currently usable

remaining_usesinteger required

Number of remaining uses

created_atstring required

When token was created

revoked_atstring nullable

When token was revoked

created_by_user_idstring nullable

User who created the token

Example response

{
  "allowed_channel_types": [
    "telegram",
    "whatsapp"
  ],
  "created_at": "2026-01-15T10:30:00Z",
  "created_by_user_id": "user-123",
  "current_uses": 2,
  "expires_at": "2026-01-17T10:30:00Z",
  "first_used_at": "2026-01-15T10:30:00Z",
  "id": "t1a2b3c4-d5e6-f7g8-h9i0-j1k2l3m4n5o6",
  "is_locked": false,
  "is_revoked": false,
  "is_valid": true,
  "max_uses": 5,
  "name": "Acme Corp Channel Setup",
  "partner_name": "Acme Corporation",
  "partner_redirect_url": "https://acme.com/setup-complete",
  "remaining_uses": 3,
  "token_prefix": "s7_cc_a1b2c3d4",
  "use_window_minutes": 30
}

Changes

No recorded changes to this operation across all 3 revisions of this API.