Skip to content
SynupAPI
Get an API key
EVENTidea.generated

AI post idea generated

Event name: idea.generated

A new AI post idea was generated. Scope: local or social (see the top-level scope field). Delivered as a signed HTTP POST to your Webhooks URL.

Every delivery is signed. Verify X-Synup-Signature before processing — see Synup Webhooks.

Payload

NameTypeRequiredDescription
eventstringoptionalDotted event name.
timestampstringoptionalISO-8601 UTC time the event was emitted.
account_idintegeroptionalSynup account the event belongs to.
location_idstringoptionalNumeric string for location-scoped events; null for brand-scoped events.
scopestringoptionalAI post-idea events only: "local" or "social".
dataobjectoptional
data.idea_idstringoptionalIdea id.
data.sourcestringoptionalHow the idea was generated.
data.idea_summaryobjectoptionalSummary: title, content_excerpt, image_url.
data.generation_batch_idstringoptionalBatch this idea belongs to.
data.social_profile_idstringoptionalBrand/social-profile id (scope:"social" only).
Example delivery
{
  "event": "idea.generated",
  "timestamp": "2026-07-15T07:20:00Z",
  "account_id": 19598,
  "location_id": "279381",
  "scope": "local",
  "data": {
    "idea_id": "idea-90211",
    "source": "scheduled",
    "idea_summary": {
      "title": "Weekend special",
      "content_excerpt": "Try our new seasonal latte...",
      "image_url": "https://cdn.example.com/i/90211.jpg"
    },
    "generation_batch_id": "batch-9"
  }
}