---
updatedAt: 2026-06-18T14:03:31.000Z
agentTools:
  projectIndex: https://docs.melhorenvio.com.br/llms.txt
---

# Solicitação do token

Autenticação

<div style={{ textAlign: "justify" }}>
  Para a solicitação do primeiro token a partir do código de autorização deverão ser informados no corpo da requisição os seguintes dados:

  * Grant Type contendo a string `authorization_code`
  * Client ID (fornecido após cadastro do app).
  * Client Secret (fornecido após cadastro do app).
  * `redirect_uri` ou callback (cadastrado no app).
  * Código fornecido após autorização (parâmetro code).

  ### Fluxo de renovação de token

  Ao final de 30 dias será necessário renovar o token através desta requisição.
  Neste processo deverão ser informados no corpo da requisição os seguintes dados:

  * Grant Type contendo a string `refresh_token`
  * Client ID (fornecido após cadastro do app).
  * Client Secret (fornecido após cadastro do app).
  * `refresh_token` obtido junto do último `access_token` requisitado.

  ### Informações de resposta

  Será retornado então um array contendo o tipo do token (Bearer), o tempo de expiração do novo token, o novo token de acesso e o novo refresh token (para futura atualização do token de acesso).

  Neste caso, o token de acesso fornecido terá vida últil de 2592000 segundos (30 dias = 30x24x60x60).
</div>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-melhor-envio-sandbox",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://sandbox.melhorenvio.com.br/",
      "description": "Ambiente de Sandbox (Testes)"
    },
    {
      "url": "https://melhorenvio.com.br/",
      "description": "Ambiente de Produção (Real)"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/oauth/token": {
      "post": {
        "summary": "Solicitação do token",
        "description": "Autenticação",
        "operationId": "solicitacao-do-token",
        "parameters": [
          {
            "name": "Accept",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "User-Agent",
            "in": "header",
            "description": "É obrigatório que seja adicionado o cabeçalho HTTP User-Agent com o nome da sua aplicação junto a um email de contato/suporte.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Aplicação (email para contato técnico)"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "grant_type",
                  "client_id",
                  "client_secret",
                  "redirect_uri",
                  "code",
                  "refresh_token"
                ],
                "properties": {
                  "grant_type": {
                    "type": "string",
                    "description": "Tipo do modo de solicitação de token"
                  },
                  "client_id": {
                    "type": "integer",
                    "description": "Obtido após a criação do aplicativo no painel do Melhor Envio",
                    "format": "int32"
                  },
                  "client_secret": {
                    "type": "string",
                    "description": "O mesmo do aplicativo gerado no painel Melhor Envio"
                  },
                  "redirect_uri": {
                    "type": "string",
                    "description": "Deve ser estática e conforme configurada no app dentro do painel Melhor Envio"
                  },
                  "code": {
                    "type": "string",
                    "description": "Resposta da autenticação"
                  },
                  "refresh_token": {
                    "type": "string",
                    "description": "Obtido da resposta junto à solicitação de token"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Novo token gerado com sucesso": {
                    "value": "{\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 2592000,\n  \"access_token\": \"eyJ0eXAiOiJKV...9FNA\",\n  \"refresh_token\": \"def502004257...b5ff\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "token_type": {
                      "type": "string",
                      "example": "Bearer"
                    },
                    "expires_in": {
                      "type": "integer",
                      "example": 2592000,
                      "default": 0
                    },
                    "access_token": {
                      "type": "string",
                      "example": "eyJ0eXAiOiJKV...9FNA"
                    },
                    "refresh_token": {
                      "type": "string",
                      "example": "def502004257...b5ff"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Dados informados incorretos": {
                    "value": "{\n  \"error\": \"invalid_client\",\n  \"error_description\": \"Client authentication failed\",\n  \"message\": \"Client authentication failed\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "invalid_client"
                    },
                    "error_description": {
                      "type": "string",
                      "example": "Client authentication failed"
                    },
                    "message": {
                      "type": "string",
                      "example": "Client authentication failed"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```