Customers

Customers events: 7 in all. See the shared envelope.

account.created

A service account was created.

Resource: account

Trigger via CLI: gotactl events trigger account.created

Example payload
{
  "id": "wev_8XwXWh2q7gP6Ksui6Wt8Rew45Yr",
  "type": "account.created",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "account",
    "resource_id": "act_8XwXWh2cdNwsn5LEq2UKWu9b4aq",
    "resource": {
      "type": "account",
      "id": "act_8XwXWh2cdNwsn5LEq2UKWu9b4aq",
      "sequence": 1
    }
  }
}

account.linked

A consumer gained access to an account.

Resource: account

Not supported by `events trigger` (use the normal API flow).

Example payload
{
  "id": "wev_8XwXWh2qyjWcRvtNxUDFJ6z2cab",
  "type": "account.linked",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "account",
    "resource_id": "act_8XwXWh2cdNwsn5LahRimZok9brr",
    "resource": {
      "type": "account",
      "id": "act_8XwXWh2cdNwsn5LahRimZok9brr",
      "sequence": 1
    }
  }
}

account.membership_revoked

A consumer's access to an account was revoked.

Resource: account

Not supported by `events trigger` (use the normal API flow).

Example payload
{
  "id": "wev_8XwXWh2qBZT7QdJP2oeBKsXbbxE",
  "type": "account.membership_revoked",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "account",
    "resource_id": "act_8XwXWh2cdNwsn5LPDx4pAmNx7Cr",
    "resource": {
      "type": "account",
      "id": "act_8XwXWh2cdNwsn5LPDx4pAmNx7Cr",
      "sequence": 1
    }
  }
}

customer.created

A customer was created.

Resource: customer

Trigger via CLI: gotactl events trigger customer.created

Example payload
{
  "id": "wev_WNxqQehDFtFd8HshBsiiraSxGaS",
  "type": "customer.created",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "customer",
    "resource_id": "cus_WNxqQehDe7QFfsrfEZKBiY4SGJ6",
    "resource": {
      "type": "customer",
      "id": "cus_WNxqQehDe7QFfsrfEZKBiY4SGJ6",
      "sequence": 1
    }
  }
}

property.created

A property was created.

Resource: property

Not supported by `events trigger` (use the normal API flow).

Example payload
{
  "id": "wev_QBY25Lrni4wUBWSWMbmU2CXRMSM",
  "type": "property.created",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "property",
    "resource_id": "prp_QBY25LrnDX7VWLNvLvrZCPqmDMp",
    "resource": {
      "type": "property",
      "id": "prp_QBY25LrnDX7VWLNvLvrZCPqmDMp",
      "sequence": 1
    }
  }
}

property.transferred

A property moved to another customer.

Resource: property

Not supported by `events trigger` (use the normal API flow).

Example payload
{
  "id": "wev_QBY25LrnimTwaDADdguQbHowWMW",
  "type": "property.transferred",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "property",
    "resource_id": "prp_QBY25LrnDX7VWLNvLfbrQckZ85z",
    "resource": {
      "type": "property",
      "id": "prp_QBY25LrnDX7VWLNvLfbrQckZ85z",
      "sequence": 1
    }
  }
}

Receiving these events

Your webhook endpoint receives each of these events as a POST with the shared envelope described in the table below. Check the signature before acting on it, answer quickly with a 2xx code and do the work afterwards: a slow or failed answer is sent again. The same event can arrive more than once, so use its id to ignore repeats.

FieldTypeMeaning
idstringThe event identifier; the same on every delivery attempt.
typestringThe event name, for example invoice.issued.
api_versionstringThe API version the body is written in.
tenant_idstringThe utility (workspace) where the event happened.
created_atstring (RFC 3339)When the event was recorded.
request_idstringThe API request that caused the change, when there was one; links to the request log.
data.resource_typestringThe type of the resource that changed.
data.resource_idstringThat resource's identifier, to read it from the API.
data.attributesobjectFields specific to each event; may be absent. Read the resource from the API for its full state.
data.resource.sequenceintegerCounts the events about the same resource; ignore an event that is not newer than the last one you applied.

Other event categories