> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.askelephant.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.askelephant.ai/_mcp/server.

# Tag created

POST 

Fired when a new tag is created in the workspace.

Reference: https://docs.askelephant.ai/api-reference/webhook-events/tag-created-webhook

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: AskElephant Public API
  version: 1.0.0
paths: {}
webhooks:
  tag-created-webhook:
    post:
      operationId: tag-created-webhook
      summary: Tag created
      description: Fired when a new tag is created in the workspace.
      parameters:
        - name: svix-id
          in: header
          description: >-
            Unique identifier for this webhook delivery. Header names are
            case-insensitive.
          required: true
          schema:
            type: string
        - name: svix-timestamp
          in: header
          description: >-
            Unix timestamp used when verifying the webhook signature. Header
            names are case-insensitive.
          required: true
          schema:
            type: string
        - name: svix-signature
          in: header
          description: >-
            Signature for the raw webhook payload. Use this with the delivery
            ID, timestamp, and your endpoint secret to verify authenticity.
            Header names are case-insensitive.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/webhook_tag_payload'
components:
  schemas:
    webhook_tag_event_type:
      type: string
      enum:
        - v1.tag.created
        - v1.tag.updated
        - v1.tag.deleted
      description: Event types emitted for tag webhooks.
      title: webhook_tag_event_type
    TagObject:
      type: string
      enum:
        - tag
      title: TagObject
    tag:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/TagObject'
        id:
          type: string
        name:
          type: string
        hex_color:
          type:
            - string
            - 'null'
        description:
          type:
            - string
            - 'null'
        auto_tagging_enabled:
          type: boolean
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - object
        - id
        - name
        - created_at
        - updated_at
      title: tag
    WebhookTagPayloadDataPreviousAttributes:
      type: object
      properties: {}
      description: >-
        Only present on updated events. Contains the previous values of fields
        that changed.
      title: WebhookTagPayloadDataPreviousAttributes
    WebhookTagPayloadData:
      type: object
      properties:
        object:
          $ref: '#/components/schemas/tag'
        previous_attributes:
          $ref: '#/components/schemas/WebhookTagPayloadDataPreviousAttributes'
          description: >-
            Only present on updated events. Contains the previous values of
            fields that changed.
      required:
        - object
      title: WebhookTagPayloadData
    webhook_tag_payload:
      type: object
      properties:
        id:
          type: string
          description: Unique event identifier.
        type:
          $ref: '#/components/schemas/webhook_tag_event_type'
        api_version:
          type: string
          description: API version used when the event was generated.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the event was created.
        workspace_id:
          type: string
          description: Workspace that owns the resource.
        data:
          $ref: '#/components/schemas/WebhookTagPayloadData'
      required:
        - id
        - type
        - api_version
        - created_at
        - workspace_id
        - data
      description: Webhook payload delivered when a tag is created, updated, or deleted.
      title: webhook_tag_payload

```