RIrillet
Webhooks

POST Webhook customer-updated

Webhook to notify when a customer is updated. Changes that only affect customer metadata do not emit this webhook.

Headers

X-Rillet-Signaturestring required

Signature of the webhook event. Computed using HMAC-SHA256 and AES encrypted with the configured webhook token. The contents of the body are prefixed with the timestamp and id before hashing.

X-Rillet-Timestampstring date-time required

Timestamp of the webhook event in ISO-8601 format

X-Rillet-Idstring uuid required

ID of the webhook event

X-Rillet-Entitystring required

Entity type of the webhook event

X-Rillet-Eventstring required

Event type of the webhook event

Payload

idstring uuid required
updated_atstring date-time required

ISO 8601 timestamp in UTC timezone (must end with 'Z')

metadataobject

Customer metadata values keyed by metadata definition key.

family_idstring uuid nullable

The family this customer belongs to. Set through the customer-families endpoints, not here.

parent_customer_idstring uuid nullable

The member this customer reports to within its family. The family's root parent reports to no one.

namestring required
name_on_invoicestring
payment_termsinteger
send_invoices_automaticallyboolean

When set to true, invoices for this customer will be automatically sent via email on the invoice date.

send_payment_remindersboolean

When set to true, an email will be sent to customers periodically if they have not paid an invoice.

allow_online_paymentsboolean

Allows this customer to pay invoices online via Stripe, and must be true before auto-payment can be set up for them. Omit on create to leave online payments off; omit on update to keep the customer's current setting. Enabling it requires Stripe to be configured for at least one subsidiary.

Example payload

{
  "name": "Bob",
  "name_on_invoice": "Bob Johnson",
  "address": {
    "line1": "123 Main St",
    "line2": "Apt 4B",
    "city": "Nashville",
    "state": "TN",
    "zip_code": "37201",
    "country": "US"
  },
  "shipping_address": {
    "line1": "123 Main St",
    "line2": "Apt 4B",
    "city": "Nashville",
    "state": "TN",
    "zip_code": "37201",
    "country": "US"
  },
  "billing_addresses": [
    {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "Nashville",
      "state": "TN",
      "zip_code": "37201",
      "country": "US"
    }
  ],
  "shipping_addresses": [
    {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "Nashville",
      "state": "TN",
      "zip_code": "37201",
      "country": "US"
    }
  ],
  "emails": [
    {
      "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
      "email": "bobjohnson@somedomain.com"
    }
  ],
  "external_references": [
    {
      "type": "xyzSystemId",
      "id": "234",
      "url": "https://xyzsystempage.com/ids/234"
    }
  ],
  "tax_ids": [
    {
      "value": "DE123456789"
    }
  ]
}

Response

OK

string required

A placeholder indicating a response from a webhook. The contents of this response are ignored.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.