Crie o app
- 1No PostNimbo, abra Settings > Apps e crie um app OAuth com nome, descrição, imagem e endereço de redirecionamento.
- 2Copie o client id e o client secret. Mantenha o secret no seu servidor; se ele vazar, gere um novo na mesma página.
O fluxo authorization code
Envie o membro para a tela de consentimento com seu client id, o endereço de redirecionamento, um valor de state e um desafio PKCE S256, recomendado para todo app e obrigatório para apps que não conseguem guardar um secret.
https://postnimbo.com/oauth/authorize ?client_id=<client id> &response_type=code &redirect_uri=<your redirect address> &state=<random value> &code_challenge=<base64url(sha256(verifier))> &code_challenge_method=S256 &scope=posts:read posts:schedule
Depois que ele aprovar, o PostNimbo redireciona para o seu endereço com code e state. Verifique o state e troque o code em poucos minutos:
curl -X POST https://postnimbo.com/api/oauth/token \ -d grant_type=authorization_code \ -d code=<code> \ -d client_id=<client id> \ -d client_secret=<client secret> \ -d code_verifier=<verifier> \ -d redirect_uri=<your redirect address>
{
"access_token": "pos_…",
"token_type": "bearer",
"scope": "posts:read posts:schedule"
}Envie o token de acesso no header Authorization da API REST. Ele continua funcionando até o membro revogar seu app; armazene-o criptografado.
Escopos
Peça apenas o que seu app usa. A tela de consentimento lista cada um com estas palavras. Não pedir nenhum dá acesso total ao token, então prefira usar escopos.
ideas:writeSave ideas to your Ideas board, and remove ideas you saved (Undo)media:writeAdd images to your media libraryposts:readSee your brands, channels, scheduled posts and the posts waiting for approvalposts:scheduleSchedule posts to your channels (when your workspace asks for approval, your approvers get them first)ai:useWrite drafts with PostNimbo AI, within your plan's AI featureslink-in-bio:writeAdd links to your link-in-bio pagesanalytics:readSee a summary of your analyticsinbox:readSee how many inbox conversations are unreadwebhooks:writeSend an event to an address you choose (like Zapier, Make or n8n) when a post is published, a flow captures a lead (with its email or phone number) or a flow is completed
O que o token pode fazer
- Ele age como o membro que o aprovou: apenas as marcas e os canais dele, e os níveis de canal que o workspace lhe deu.
- Quando o workspace exige aprovação, os posts que ele agenda aguardam os aprovadores como os do próprio membro.
- Uma rota fora dos seus escopos retorna 403. Peça ao membro que faça login de novo para conceder mais.
