---
title: "POST /v2/integrations/gatsby/events"
method: POST
path: "/v2/integrations/gatsby/events"
tags: ["integrations", "gatsby"]
---

# POST /v2/integrations/gatsby/events

`POST /v2/integrations/gatsby/events`

## Request

- Base URL: `https://api.loyaltylion.com`
- URL: `https://api.loyaltylion.com/v2/integrations/gatsby/events`
- Auth: HTTP bearer

## Request body

- IntegrationsGatsbyEventRequestBody
  - `event` object, required: The Gatsby event, with a `platform` and `eventName` property
    - `platform` 'INSTAGRAM' | 'TIKTOK', required
    - `eventName` 'MENTIONED_YOU' | 'DM' | 'FOLLOWED_YOU', required
    - `eventDetails` object, required
      - `likes` number, nullable
      - `comments` number, nullable
      - `caption` string, nullable
      - `mediaUrl` string, nullable
      - `mediaType` string, nullable
      - `mentionType` string, nullable
    - `tags` string[], required
    - `segments` string[], required
    - `instagram` object, nullable
      - `userName` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `posts` number, nullable
      - `followers` number, nullable
      - `follows` number, nullable
      - `verified` boolean, nullable
      - `profileImage` string, nullable
      - `followsYou` boolean, nullable
      - `lastMentionDate` string, nullable
      - `lastPublishDate` string, nullable
    - `tiktok` object, nullable
      - `userName` string, nullable
      - `profileImage` string, nullable
      - `bio` string, nullable
      - `lastMentionDate` string, nullable
      - `lastPublishDate` string, nullable

## Response `200`

200

- IntegrationsGatsbyEventResponseBody
  - `result` 'processed' | 'ignored', required: Indicates how the event was handled by LoyaltyLion. `processed` means we understood the event and acted upon it. `ignored` means we did not process the event, e.g. it was malformed, or the associated Gatsby integration is no longer active
  - `details` string: Additional context relating to the `result`

## Other responses

- `400`: Bad Request
- `401`: 401
- `403`: 403

## Changes

- **2026-11-03** `69cbd7bf7128`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/changes/v2/integrations/gatsby/events/post.md)

---

[API](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api.md) - [All operations](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loyaltylion/apis/loyaltylion-admin-api/revisions/69cbd7bf7128?raw)