Webhooks - Corsair

The Cloudcart plugin handles incoming webhooks. Point your provider’s subscription URL at your Corsair HTTP handler (see Overview for setup context and the exact URL shape).

New to Corsair? See webhooks and hooks.

Webhook map

customer
- created (customer.created)
order
- created (order.created)
product
- created (product.created)

HTTP handler setup

app/api/webhook/route.ts

import { processWebhook } from "corsair";
import { corsair } from "@/server/corsair";

export async function POST(request: Request) {
    const headers = Object.fromEntries(request.headers);
    const body = await request.json();
    const result = await processWebhook(corsair, headers, body);
    return result.response;
}

Events

Customer

Created

customer.created Customer created webhook event Payload

Name	Type	Required	Description
`id`	`string \| number`	Yes	—
`email`	`any`	Yes	—

Response data full type

{
  id: string | number,
  email: any
}

webhookHooks example

cloudcart({
    webhookHooks: {
        customer: {
            created: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

Order

Created

order.created Order created webhook event Payload

Name	Type	Required	Description
`id`	`string \| number`	Yes	—
`order_total`	`any`	Yes	—

Response data full type

{
  id: string | number,
  order_total: any
}

webhookHooks example

cloudcart({
    webhookHooks: {
        order: {
            created: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

Product

Created

product.created Product created webhook event Payload

Name	Type	Required	Description
`id`	`string \| number`	Yes	—
`sku`	`any`	Yes	—

Response data full type

{
  id: string | number,
  sku: any
}

webhookHooks example

cloudcart({
    webhookHooks: {
        product: {
            created: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​Webhook map

​HTTP handler setup

​Events

​Customer

​Created

​Order

​Created

​Product

​Created

Webhook map

HTTP handler setup

Events

Customer

Created

Order

Created

Product

Created