Delete a post

Deletes the specified post campaign. This is permanent: the post is removed from Listings API and unpublished from every site it reached (Google, Facebook). Deleting a live post takes it down from the connected profiles; there is no undo.

Use case: retract a mistaken announcement. If an announcement went out with the wrong hours, delete it with DELETE /posts/{postId} (using the id from the posts list), confirm success: true, then publish a corrected one with POST /posts. To pull a campaign from every store at once, delete the bulk campaign by its bulk ID instead.

Notes.

• The request body is optional. Send clientMutationId only if you want the value echoed back for request correlation; the generated snippet includes it as an example.
• A post that already finished its scheduled window may report status: EXPIRED and no longer be live on each site, but deleting it still clears it from Listings API.
• Deleting an already-deleted or unknown post returns an error envelope ({"data":null,"errors":[...]}) rather than success: true.

Write operation: not executed against the live account. The request and response shown are built from the API schema.