> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suave.money/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Webhook

> Create a new webhook subscription for the current vendor.



## OpenAPI

````yaml POST /api/v1/webhook_subscription
openapi: 3.0.0
info:
  title: Suave API
  version: 0.0.1
servers:
  - url: https://checkout.suave.money
security: []
paths:
  /api/v1/webhook_subscription:
    post:
      summary: Create Webhook Subscription
      description: Create a new webhook subscription for the current vendor.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                webhook_url:
                  type: string
                env_mode:
                  type: string
                  description: >-
                    The `env_mode` parameter allows you to specify whether the
                    webhook is intended for testing or production environments.
                  enum:
                    - test
                    - live
                  default: live
      responses:
        '200':
          description: Subscription created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      Successfully registered webhook endpoint in test|live mode
                      for {vendor_name}.
                  data:
                    type: object
                    properties:
                      webhook_id:
                        type: string
                        example: ep_2k4DQEpnKDxp1TcvsNIRiKDBQtj
                      webhook_url:
                        type: string
                        example: webhook endpoint url
                      env_mode:
                        type: string
                        enum:
                          - test
                          - live
                        example: test
                      created_at:
                        type: string
                        format: date-time
                        example: '2024-08-01T17:38:56.892Z'
                      updated_at:
                        type: string
                        format: date-time
                        example: '2024-08-01T17:38:56.892Z'

````