Skip to main content
POST
/
api
/
v1
/
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"
  }'

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

​
Request Body

​
grant_type
string
required
Tipo de autenticação. Valores aceitos: client_credentials ou refresh_token.
​
client_id
string
ID do cliente OAuth. Obrigatório quando grant_type=client_credentials.
​
client_secret
string
Secret do cliente OAuth. Obrigatório quando grant_type=client_credentials.
​
refresh_token
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"
}
​
access_token
string
JWT token para autenticar nas requisições da API. Válido por 1 hora.
​
token_type
string
Sempre "Bearer".
​
expires_in
number
Tempo de expiração em segundos (3600 = 1 hora).
​
refresh_token
string
Token para renovar o access token sem re-autenticar. Válido por 30 dias. Uso único (rotation).
​
scope
string
Permissões concedidas ao token.

​
Erros

StatusDescrição
400Parâmetros inválidos ou ausentes
401Credenciais inválidas ou refresh token expirado/revogado
429Rate 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"
  }'