---
title: "Creator added"
method: POST
path: "creator.created"
tags: ["Webhook Events"]
---

# Creator added

`POST creator.created` (webhook)

A creator was added to your roster: by hand, by accepting an application, by approving a join request, or through an invitation link. `via` and the ids say which.

## Headers

- `webhook-id` string, required
- `webhook-timestamp` string, required
- `webhook-signature` string, required

## Payload

- CreatorCreatedWebhookEvent: A creator was added to your roster: by hand, by accepting an application, by approving a join request, or through an invitation link. `via` and the ids say which.
  - `id` string, required: Event id; the `webhook-id` header. The same on every retry: dedupe on it.
  - `type` 'creator.created', required
  - `timestamp` string, date-time, required: When the change happened
  - `organizationId` string, required
  - `actor` WebhookActor, required: Who caused the event: a member (`user`), an API key (`apiKeyId`), a creator, or viral.app itself (`system`); `surface` says where the change entered. Skip events your own API key caused to avoid loops.
    - `type` 'user' | 'api_key' | 'creator' | 'system', required
    - `surface` 'ui' | 'api' | 'copilot' | 'system', required
    - `userId` string, nullable, required
    - `apiKeyId` string, nullable, required
    - `impersonated` boolean, required
  - `data` object, required
    - `creator` WebhookCreator, required
      - `id` string, required
      - `creatorUserId` string, required
      - `user` object, required
        - `id` string, required
        - `name` string, nullable, required
        - `firstName` string, nullable, required
        - `lastName` string, nullable, required
        - `image` string, nullable, required
      - `notes` string, nullable, required
      - `status` 'not invited' | 'invitation sent' | 'invitation rejected' | 'joined', required
      - `creatorStatus` 'active' | 'archived', required
      - `isMarketplaceCreator` boolean, required
      - `accounts` object[], required
        - `id` string, required
        - `platform` string, required
        - `platformAccountId` string, required
        - `username` string, nullable, required
      - `tags` object[], required
        - `id` string, required
        - `name` string, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
    - `via` 'manual' | 'invitation' | 'application' | 'join_request' | 'invite_link', required
    - `applicationId` string, nullable, required
    - `joinRequestId` string, nullable, required
    - `inviteLinkId` string, nullable, required

## Acknowledgement `200`

Any 2xx within 15 seconds acknowledges the event. Anything else, a timeout or a redirect is retried (10 attempts over about 3 days); 410 disables the endpoint.

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)