Webhooks

In this article:

What are Webhooks?

Webhooks, also referred to as web callback or HTTP push API, is an integration tool that helps to keep track of events that are happening in your store. The integrated app provides real-time information and updates about particular events connected to your store.

How do I set up Webhooks?

To enable Webhooks in your Sellfy store, you first need to create your own Webhook

Once you've created your Webhook, you can enable the integration. To do so, you'll need to provide the Title and URL of the address that you'll use to collect and work with this event data.

Technically, Sellfy creates HTTP POST requests with JSON data to the user-provided URL in the webhooks.

Available events

Type	Description
New order	Occurs whenever an order payment is completed or payment status is changed.
Email subscribe	Occurs whenever a customer is subscribed to your newsletter list.
Email unsubscribe	Occurs whenever a customer is unsubscribed from all emails.
Subscription product bought	Occurs whenever a customer makes a purchase for a subscription product. This event will recur each time the subscription renews.
Subscription product canceled	Occurs whenever a customer cancels a subscription.
Cart abandoned	Occurs whenever a customer gives consent to receive emails and doesn't complete the checkout process.
Contact form submitted	Occurs whenever a customer fills and sends a contact form.

New Order event

{
    "id": "dmnVQFUm", // Unique transaction ID
    "status": "COMPLETED",
    "currency": "USD",
    "amount": 449,
    "discount": {
        "amount": 499
    },
    "tax": {
        "amount": 0,
        "percents": 0
    },
    "customer": {
        "country": "US", // ISO 3166-1 alpha-2 format
        "payment_type": "card",
        "email": "[email protected]",
        "ip": "127.0.0.1",
        "consent_to_newsletters": true,
        "name": "John Doe",
        "address": {
            "line1": "Wall street",
            "line2": "12-b7",
            "state": "NY",
            "country": "US",
            "city": "New York",
            "tax_number": ",
            "postal_code": "10105",
            "phone": "212-487-2939"
        }
    },
    "products": [
        {
            "id": "61d2ef5352ca3cdc80662cb1",
            "key": "uQsm",
            "name": "Icon set",
            "amount": 299, // cents
            "discount": {
                "type": "coupon",
                "code": "25OFF",
                "amount": 25, // cents
                "amount_type": "percentage",
                "amount_applied": 25, // cents
                "currency": "USD"
            },
            "quantity": 1
        },
        {
            "id": "61d2ef5352ca3cdc80662cb4",
            "key": "QFUm",
            "type": "sale",
            "name": "Holiday cards",
            "amount": 0, // cents
            "discount": {
                "type": "sale",
                "amount": 500, // cents
                "amount_type": "fixed",
                "amount_applied": 399, // cents
                "currency": "USD"
            },
            "quantity": 1
        },
        {
            "id": "61d2ef5352ca3cdc80662cb7",
            "key": "dmnV",
            "name": "Awesome serif-font",
            "amount": 150, // cents
            "discount": {},
            "quantity": 1
        }
    ],
    "date": "2022-01-12T11:57:59+00:00" // ISO 8601 format
}

Email subscribe / unsubscribe

Sample JSON data

{
  "customer": {
    "email": "[email protected]"
  },
  "date": "2018-01-17T12:28:00+00:00" // ISO 8601 format
}

Subscription product bought/canceled

{
  "id": "61542a2a67cfd83cd57ae4bb", // Unique Subscription ID
  "payer_email": "[email protected]",
  "plan_name": "Subscription plan name",
  "plan_amount": 2000, // cents
  "interval": "month", // week | month | year
  "product": {
    "id": "60e5b823221c469a8daede88",
    "key": "QFUm",
    "name": "Subscription product name"
  },
  "activated_at": "2022-05-28T23:17:05+00:00", // ISO 8601 format
  "current_period_started_at": "2022-05-28T23:17:05+00:00", // ISO 8601 format
  "current_period_ends_at": "2022-06-27T23:17:05+00:00" // ISO 8601 format
}

Cart abandoned

  {
    "id": "615c388dc14058fdfc5671ec", // Unique Cart ID
    "payer_email": "[email protected]",
    "total": 968, // cents
    "currency": "USD",
    "tax": {
      "percents": 21,
      "amount": 168 // cents
    },
    "sub_total": 1000, // cents
    "last_interaction_at": "2022-05-28T17:17:05+00:00", // ISO 8601 format
    "items": [
      {
        "price": 1000, // cents
        "discount": 200, // cents
        "total": 800, // cents
        "product": {
          "id": "60e5b823221c469a8daede88",
          "key": "zmsy7q",
          "name": "Holiday cards",
          "selected_variant": "Default"
        },
        "sub_total": 1000 // cents
      }
    ]
  }

Contact form submitted

  {
    "email": "[email protected]",
    "subject": "Email subject",
    "body": "Email body text",
    "sent_at": "2022-05-30T10:50:02+00:00" // ISO 8601 format
  }