Create Webhook

POST

https://v3.mangoteeprints.com/api/public/v1/webhooks

Last modified:2025-08-22 08:09:57

Create a new webhook subscription.

Subscribe to receive notifications when order status changes or shipment updates occur.

Supported Events:

order.status: Triggered when order status changes (e.g., new_order → in_production)

order.shipment: Triggered when tracking information is updated

Requirements:

Webhook URL must be publicly accessible

URL must respond with 2xx status code within 10 seconds

Failed webhooks will be retried up to 3 times

Rate Limits:

Maximum 10 webhooks per user

Maximum 100 webhook calls per minute per user

Request

Header Params

Body Params application/json

Example

{
    "name": "My Order Updates",
    "url": "https://example.com/webhook",
    "events": [
        "order.status",
        "order.shipment"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v3.mangoteeprints.com/api/public/v1/webhooks' \
--header 'X-API-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "My Order Updates",
    "url": "https://example.com/webhook",
    "events": [
        "order.status",
        "order.shipment"
    ]
}'

Responses

🟢200Successful Response

application/json

Body

Example

{
    "created_at": "2024-01-15 10:30:00",
    "events": [
        "order.status",
        "order.shipment"
    ],
    "failure_count": "0",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "is_active": true,
    "last_status_code": "200",
    "last_triggered_at": "2024-01-15 11:00:00",
    "name": "My Order Updates",
    "updated_at": "2024-01-15 10:30:00",
    "url": "https://example.com/webhook"
}

🟠422Validation Error

Modified at 2025-08-22 08:09:57

Webhooks

List Webhooks