---
title: "AI post idea generated"
method: POST
path: "idea.generated"
tags: ["Webhooks/Webhooks", "Webhooks"]
---

# AI post idea generated

`POST idea.generated` (webhook)

**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.

## Headers

- `X-Synup-Signature` string, required

## Payload

- object
  - `event` string: Dotted event name.
  - `timestamp` string: ISO-8601 UTC time the event was emitted.
  - `account_id` integer: Synup account the event belongs to.
  - `location_id` string: Numeric string for location-scoped events; null for brand-scoped events.
  - `scope` string: AI post-idea events only: "local" or "social".
  - `data` object
    - `idea_id` string: Idea id.
    - `source` string: How the idea was generated.
    - `idea_summary` object: Summary: title, content_excerpt, image_url.
    - `generation_batch_id` string: Batch this idea belongs to.
    - `social_profile_id` string: Brand/social-profile id (scope:"social" only).

## Acknowledgement `200`

Your endpoint acknowledges receipt with any 2xx. A non-2xx response or a timeout (>10s) is treated as a failed delivery.

- object

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)