POST /oauth/token - RCS Convertt API

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "rcs_a1b2c3d4e5f67890",
    "client_secret": "seu-secret-aqui"
  }'

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "refresh_token",
    "refresh_token": "seu-refresh-token"
  }'

{
  "access_token": "<string>",
  "token_type": "<string>",
  "expires_in": 123,
  "refresh_token": "<string>",
  "scope": "<string>"
}

POST

api

oauth

token

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "rcs_a1b2c3d4e5f67890",
    "client_secret": "seu-secret-aqui"
  }'

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "refresh_token",
    "refresh_token": "seu-refresh-token"
  }'

{
  "access_token": "<string>",
  "token_type": "<string>",
  "expires_in": 123,
  "refresh_token": "<string>",
  "scope": "<string>"
}

Request Body

string

required

Tipo de autenticação. Valores aceitos: client_credentials ou refresh_token.

string

ID do cliente OAuth. Obrigatório quando grant_type=client_credentials.

string

Secret do cliente OAuth. Obrigatório quando grant_type=client_credentials.

string

Refresh token válido. Obrigatório quando grant_type=refresh_token.

Resposta de Sucesso (200)

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "a1b2c3d4e5f6789...",
  "scope": "campaigns:dispatch"
}

string

JWT token para autenticar nas requisições da API. Válido por 1 hora.

string

Sempre "Bearer".

number

Tempo de expiração em segundos (3600 = 1 hora).

string

Token para renovar o access token sem re-autenticar. Válido por 30 dias. Uso único (rotation).

string

Permissões concedidas ao token.

Erros

Status	Descrição
400	Parâmetros inválidos ou ausentes
401	Credenciais inválidas ou refresh token expirado/revogado
429	Rate limit excedido (10 req/min)

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "rcs_a1b2c3d4e5f67890",
    "client_secret": "seu-secret-aqui"
  }'

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "refresh_token",
    "refresh_token": "seu-refresh-token"
  }'

​Request Body

​Resposta de Sucesso (200)

​Erros

Request Body

Resposta de Sucesso (200)

Erros