Primeros pasos
Crea tu clave API y haz tu primera llamada en menos de 5 minutos.
Crea tu clave API y haz tu primera llamada en menos de 5 minutos.
El acceso a la API y MCP requiere un workspace con plan Creator, Pro o Agency. Cada clave pertenece a un workspace y a los permisos seleccionados; activa analytics:read si tu integración necesita estadísticas.
Tu clave tendrá este formato: dpk_live_aBcDeFgHiJkL...
Guarda tu clave API de forma segura. Nunca la subas a control de versiones ni la compartas públicamente.
Asegúrate de tener al menos una cuenta social conectada en dopost. Luego consulta tus cuentas:
curl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/social/accountscurl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/social/accountsRespuesta:
{
"accounts": [
{
"id": "cm3xyz789ghi012",
"platform": "LINKEDIN",
"platformUsername": "johndoe",
"platformUserId": "urn:li:person:a1B2c3D4e5"
}
]
}{
"accounts": [
{
"id": "cm3xyz789ghi012",
"platform": "LINKEDIN",
"platformUsername": "johndoe",
"platformUserId": "urn:li:person:a1B2c3D4e5"
}
]
}Copia el id de la cuenta donde quieres publicar.
curl -X POST \
-H "x-api-key: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"accountId": "<accountId>",
"text": "¡Hola desde la API de dopost!"
}' \
https://dopost.co/api/v1/post/publishcurl -X POST \
-H "x-api-key: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"accountId": "<accountId>",
"text": "¡Hola desde la API de dopost!"
}' \
https://dopost.co/api/v1/post/publishRespuesta (202 Accepted):
{
"success": true,
"jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"postId": "cm3abc123def456",
"status": "processing"
}{
"success": true,
"jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"postId": "cm3abc123def456",
"status": "processing"
}Usa el postId para consultar los detalles de tu post:
curl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/post/<postId>curl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/post/<postId>Respuesta:
{
"id": "cm3abc123def456",
"status": "PUBLISHED",
"platform": "LINKEDIN",
"text": "¡Hola desde la API de dopost!",
"postUrl": "https://linkedin.com/feed/update/urn:li:share:123456"
}{
"id": "cm3abc123def456",
"status": "PUBLISHED",
"platform": "LINKEDIN",
"text": "¡Hola desde la API de dopost!",
"postUrl": "https://linkedin.com/feed/update/urn:li:share:123456"
}Estos errores pueden ser devueltos por cualquier endpoint:
| Estado | Error | Causa |
|---|---|---|
401 | Invalid or missing API key | Cabecera x-api-key incorrecta o ausente |
403 | API key does not have permission for this action | La API key no tiene el scope necesario para este endpoint. Revisa sus permisos en Ajustes → API keys |
429 | Monthly post limit reached | Se ha superado la cuota mensual de publicaciones de tu plan. Mejora tu plan o espera al siguiente ciclo de facturación |
429 | Rate limit exceeded | Demasiadas peticiones. Revisa las cabeceras X-RateLimit-* y reintenta tras el tiempo indicado |
Integración con n8n — Conecta tu cuenta y automatiza publicaciones desde workflows
Endpoint de publicación — Publicación, programación, respuestas, hilos y media
Obtener post — Consulta los detalles y estado de un post por ID
Configuración de Postman — Importa nuestra colección para pruebas rápidas