instagram-media.tagged
Sent when a profile's new Instagram post tags your brand, with the Instagram media and the profile.
Use it to react when a known customer or creator tags your brand on Instagram, for example to thank them or reward them in another system.
When it fires
- When Cevoid picks up a new Instagram post that tags your brand and was published by an Instagram account that matches a profile.
- Posts by accounts that match no profile send nothing, and neither do hashtag posts.
- If the post is removed before Cevoid sends the event, nothing is sent.
Receive it
Pick instagram-media.tagged in a webhook destination's events, or tick All events. See Create a destination.
To filter it or wait before sending, send it from a Flow on the Instagram tag trigger instead. See Send from a Flow.
Use the media
instagram_media has no Cevoid ID: the post becomes a Cevoid post only once you have the rights to use it. media_url and thumbnail_url are Instagram's own URLs. They expire, and Instagram leaves them out for some videos, so download the file if you need to keep it.
Payload
{
"created_at": "2026-11-02T09:30:00.000Z",
"data": {
"instagram_media": {
"caption": "Summer outfit",
"external_id": "18000000000000000",
"media_url": "https://scontent.cdninstagram.com/v/summer-look.jpg",
"posted_at": "2026-08-01T09:00:00.000Z",
"slides": [
{
"media_url": "https://scontent.cdninstagram.com/v/summer-look.jpg",
"type": "IMAGE"
},
{
"media_url": "https://scontent.cdninstagram.com/v/summer-look.mp4",
"thumbnail_url": "https://scontent.cdninstagram.com/v/summer-look-thumbnail.jpg",
"type": "VIDEO"
}
],
"type": "CAROUSEL_ALBUM",
"url": "https://www.instagram.com/p/example/",
"username": "sarah.lifestyle"
},
"profile": {
"avatar_url": "https://cdn.cevoid.com/avatars/prf_sarah/profile.jpg",
"bio": "Lifestyle creator and photography enthusiast",
"birthday": "1992-04-18",
"country": "US",
"created_at": "2026-01-15T09:30:00.000Z",
"email": "sarah.johnson@example.com",
"external_id": "customer_7391056823401",
"first_name": "Sarah",
"id": "prf_sarah",
"language": "en",
"last_name": "Johnson",
"location": "San Francisco, CA",
"name": "Sarah Johnson",
"notes": "VIP customer; prefers email communication",
"social_instagram_handle": "sarah.lifestyle",
"social_tiktok_handle": "sarah.creates",
"social_x_handle": "sarah_j",
"updated_at": "2026-01-20T14:22:15.000Z"
}
},
"id": "evt_m3p82kdq5xw7tz4c",
"type": "instagram-media.tagged",
"version": 1
}Show all 48 linesShow fewer lines
versionnumberrequiredThe version of this event type. A published version only gains fields, so ignore fields you do not use; a breaking change is a new version.
idstringrequiredStable event id (evt_ plus 16 characters), also sent as the webhook-id header. Retries and manual replays send the same id, so ignore an event whose id you have already processed.
typestringrequiredWhat data describes. New types are added over time, and an endpoint on "All events" receives them, so ignore any type you do not handle.
created_atstring<date-time>requiredWhen the event happened, as an ISO 8601 timestamp.
originobjectWhy your endpoint received the event. Omitted when the event was forwarded without a Flow of your own.
dataobjectrequiredThe resources the event carries, keyed by resource name. type decides which resources are included, and resources your plan does not include are left out.