Référence API

Liste vos comptes connectés. Appelez-le une fois et stockez les identifiants dans la configuration de votre outil : un nom d'affichage change quand vous renommez une page, un identifiant jamais.

curl https://hello-socials.com/api/v1/accounts \
  -H "Authorization: Bearer hs_live_xxx"

{
  "data": [
    {
      "id": "cmnj4p2z0000abcd",
      "network": "TWITTER",
      "username": "hellowesign",
      "displayName": "HelloWeSign",
      "status": "connected"
    },
    {
      "id": "cmnj53dc0000efgh",
      "network": "LINKEDIN_PAGE",
      "username": "hellowesign",
      "displayName": "HelloWeSign",
      "status": "connected"
    }
  ]
}

status indique si un compte doit être reconnecté avant de lui envoyer quoi que ce soit : connected, expiring_soon ou expired.

Crée une publication programmée : texte seul, avec des images ou avec une vidéo. X, LinkedIn, Facebook et Threads acceptent le texte seul ; Instagram, Pinterest et TikTok exigent une image ou une vidéo. YouTube n'est pas encore disponible par l'API.

curl -X POST https://hello-socials.com/api/v1/posts \
  -H "Authorization: Bearer hs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Audit trail de signature électronique : retrouver chaque étape d'\''un document.",
    "socialAccountIds": ["cmnj53dc0000efgh"],
    "scheduledAt": "2026-09-04T09:30:00Z",
    "media": [
      { "url": "https://example.com/images/audit-trail.png" }
    ]
  }'

Vidéo vers TikTok et en reel Instagram en un seul appel :

curl -X POST https://hello-socials.com/api/v1/posts \
  -H "Authorization: Bearer hs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Nouvelle fonctionnalité #meetarabic",
    "socialAccountIds": ["<tiktok-account-id>", "<instagram-account-id>"],
    "scheduledAt": "2026-10-20T18:00:00+02:00",
    "media": [
      { "url": "https://example.com/videos/demo.mp4", "type": "video", "coverTimestampMs": 2500 }
    ],
    "postType": "reel",
    "tiktok": { "privacyLevel": "PUBLIC_TO_EVERYONE", "disableComment": false }
  }'

"2026-09-04T09:30:00Z"        ✓
"2026-09-04T11:30:00+02:00"   ✓
"2026-09-04T09:30:00"         ✗ pas de fuseau
"2026-09-04"                  ✗

{
  "error": "Caption exceeds the character limit for at least one target network",
  "details": {
    "accounts": [{ "id": "cmnj4p2z0000abcd", "network": "TWITTER", "limit": 280, "length": 412 }]
  }
}

Renvoie l'état d'une publication, réseau par réseau. La publication est asynchrone : la création répond PENDING, et le résultat réel n'existe qu'après le passage du worker.

{
  "data": {
    "id": "cmtlg7ca2000004jp",
    "status": "PUBLISHED",
    "scheduledAt": "2026-09-04T09:30:00.000Z",
    "publishedAt": "2026-09-04T09:30:12.000Z",
    "media": [{ "url": "https://…/posts/…/k3J9x.jpg" }],
    "results": [
      {
        "socialAccountId": "cmnj53dc0000efgh",
        "network": "LINKEDIN_PAGE",
        "status": "PUBLISHED",
        "externalId": "urn:li:share:7123456789",
        "error": null
      }
    ]
  }
}