Saltar al contenido
Desarrolladores

Apps OAuth

Permite que otros usuarios de PostNimbo conecten tu producto. Inician sesión, ven lo que pides, lo aprueban y pueden revocarlo cuando quieran en Configuración > Apps.

Crea la app

  1. 1En PostNimbo, abre Configuración > Apps y crea una app OAuth con su nombre, descripción, imagen y dirección de redirección.
  2. 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.

1. Abre la pantalla de consentimiento
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:

2. Intercambia el code
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>
3. La respuesta
{
  "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 library
  • posts:readSee your brands, channels, scheduled posts and the posts waiting for approval
  • posts: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 features
  • link-in-bio:writeAdd links to your link-in-bio pages
  • analytics:readSee a summary of your analytics
  • inbox:readSee how many inbox conversations are unread
  • webhooks: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.

¿Estás creando algo con PostNimbo?

Cuéntanos qué estás haciendo. Te ayudamos con la API, revisamos apps para el directorio y agregamos los endpoints que necesitan las integraciones.