Crea la app
- 1En PostNimbo, abre Configuración > Apps y crea una app OAuth con su nombre, descripción, imagen y dirección de redirección.
- 2Copia el client id y el client secret. Guarda el secret en tu servidor; renuévalo desde la misma página si se filtra.
El flujo authorization code
Envía al miembro a la pantalla de consentimiento con tu client id, la dirección de redirección, un valor state y un challenge PKCE S256, recomendado para todas las apps y obligatorio para las que no pueden guardar un 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
Cuando lo aprueba, PostNimbo redirige a tu dirección con code y state. Comprueba el state y luego intercambia el code en unos pocos 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"
}Envía el token de acceso en el encabezado Authorization de la API REST. Sigue funcionando hasta que el miembro revoque tu app; guárdalo cifrado.
Ámbitos
Pide solo lo que usa tu app. La pantalla de consentimiento muestra cada uno con estas palabras. Si no pides ninguno, el token obtiene acceso completo, así que mejor usa scopes.
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
Qué puede hacer el token
- Actúa como el miembro que lo aprobó: solo sus marcas y canales, con los niveles de canal que le dio su espacio de trabajo.
- Cuando el espacio de trabajo exige aprobación, las publicaciones que programa esperan a los aprobadores igual que las del propio miembro.
- Una ruta fuera de sus scopes responde 403. Pide al miembro que vuelva a iniciar sesión para conceder más.
