Color mode

DjaoApp Notifications Reference

These are notifications sent by DjaoApp.

You can edit the notification e-mail templates in the Themes dashboard page.

Alphabetical

Card expires soon

This notification is sent when a credit card on file is about to expire.

Definition

event

"card_expires_soon"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

nb_expiration_days

integer

number of days before the card expires

last4

string

Last 4 digits of the credit card on file

exp_date

string

Expiration date of the credit card on file

Examples

{
  "event": "card_expires_soon",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "last4": "4242",
  "exp_date": "07/2023",
  "nb_expiration_days": 15
}

Card updated

This notification is sent when a credit card on file is updated.

Definition

event

"card_updated"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

changes

object

changes to the profile

Examples

{
  "event": "card_updated",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "profile": {
    "slug": "xia",
    "printable_name": "Xia Lee",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "changes": {
    "last4": {
      "pre": "4674",
      "post": "4242"
    },
    "exp_date": {
      "pre": "07/2022",
      "post": "07/2023"
    }
  }
}

Charge receipt

This notification is sent when a charge is created on a credit card. It is also sent when the charge is refunded.

Definition

event

"charge_receipt"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

charge_items

array

the line items on the charge receipt

invoiced

object

created_at

string

Date/time of creation (in ISO format)

description

string

Free-form text description for the transaction

amount

string

Amount being transfered

is_debit

string

True if the transaction is indentified as a debit in the API context

orig_account

string

Source account from which funds are withdrawn

orig_profile

string

Billing profile from which funds are withdrawn

orig_amount

integer

Amount withdrawn from source in orig_unit

orig_unit

string

Three-letter ISO 4217 code for source currency unit (ex: usd)

dest_account

string

Target account to which funds are deposited

dest_profile

string

Billing profile to which funds are deposited

dest_amount

integer

Amount deposited into target in dest_unit

dest_unit

string

Three-letter ISO 4217 code for target currency unit (ex: usd)

refunded

array

created_at

string

Date/time of creation (in ISO format)

description

string

Free-form text description for the transaction

amount

string

Amount being transfered

is_debit

string

True if the transaction is indentified as a debit in the API context

orig_account

string

Source account from which funds are withdrawn

orig_profile

string

Billing profile from which funds are withdrawn

orig_amount

integer

Amount withdrawn from source in orig_unit

orig_unit

string

Three-letter ISO 4217 code for source currency unit (ex: usd)

dest_account

string

Target account to which funds are deposited

dest_profile

string

Billing profile to which funds are deposited

dest_amount

integer

Amount deposited into target in dest_unit

dest_unit

string

Three-letter ISO 4217 code for target currency unit (ex: usd)

charge_total

object

Total amount for the charge after refunds have been applied

amount

integer

amount in unit

unit

string

Three-letter ISO 4217 code for currency unit (ex: usd)

charge

object

the charge that relates to the notification

created_at

string

Date/time of creation (in ISO format)

amount

integer

Total amount in currency unit

unit

string

Three-letter ISO 4217 code for currency unit (ex: usd)

readable_amount

string

Amount and unit in a commonly accepted readable format

description

string

Description for the charge as appears on billing statements

last4

string

Last 4 digits of the credit card used

exp_date

string

Expiration date of the credit card used

processor_key

string

Unique identifier returned by the payment processor

state

string

Current state (i.e. created, done, failed, disputed)

detail

string

Feedback for the user in plain text

Examples

{
  "event": "charge_receipt",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "charge_items": [
    {
      "invoiced": {
        "created_at": "2022-01-01T00:00:00Z",
        "description": "subscription to premium",
        "amount": 11900,
        "is_debit": false,
        "orig_account": "Receivable",
        "orig_profile": "djaoapp",
        "orig_amount": 11900,
        "orig_unit": "usd",
        "dest_account": "Payable",
        "dest_profile": "xia",
        "dest_amount": 11900,
        "dest_unit": "usd"
      },
      "refunded": []
    }
  ],
  "charge": {
    "created_at": "2022-01-01T00:00:00Z",
    "amount": 11900,
    "unit": "usd",
    "readable_amount": "$119.00",
    "description": "subscription to premium",
    "last4": "4242",
    "exp_date": "07/2023",
    "processor_key": "ch_abc123",
    "state": "done"
  },
  "provider": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  }
}

Claim code

This notification is sent to the user invited through a groupBuy.

Definition

event

"claim_code_generated"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

cart_items

array

Line items paid for already

created_at

string

Date/time of creation (in ISO format)

user

object

User the cart belongs to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

plan

object

Item in the cart (if plan)

slug

string

Unique identifier shown in the URL bar

title

string

Title for the plan

option

integer

Index in the list of discounts for advance payments

full_name

string

Full name of the person that will benefit from the subscription (GroupBuy)

sync_on

string

identifier of the person that will benefit from the subscription (GroupBuy)

string

e-mail of the person that will benefit from the subscription (GroupBuy)

detail

string

Describes the result of the action in human-readable form

detail

string

Examples

{
  "event": "claim_code_generated",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "cart_items": [
    {
      "created_at": "2022-01-01T00:00:00Z",
      "user": {
        "slug": "emilie",
        "username": "emilie",
        "printable_name": "Emilie",
        "full_name": "Emilie Jolie",
        "nick_name": "Emilie",
        "picture": null,
        "type": "user",
        "credentials": false,
        "created_at": "2022-01-01T00:00:00Z",
        "last_login": null,
        "email": "emilie@localhost.localdomain",
        "phone": "415-555-5557",
        "lang": "en",
        "extra": null
      },
      "plan": {
        "slug": "premium",
        "title": "Premium"
      },
      "option": 1,
      "full_name": "Emilie Jolie",
      "sync_on": "emilie@localhost.localdomain",
      "email": "emilie@localhost.localdomain"
    }
  ],
  "provider": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  }
}

Subscription expires soon

This notification is sent when a subscription is about to expire.

Definition

event

"expires_soon"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

nb_expiration_days

integer

number of days before the subscription expires

plan

object

plan the subscription relates to

slug

string

Unique identifier shown in the URL bar

title

string

Title for the plan

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

Examples

{
  "event": "expires_soon",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "plan": {
    "slug": "premium",
    "title": "Premium"
  },
  "provider": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "nb_expiration_days": 15
}

Order confirmation

This notification is sent when an order has been confirmed but a charge has not been successfully processed yet.

Definition

event

"order_executed"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

invoiced_items

array

Line items to charge on checkout

created_at

string

Date/time of creation (in ISO format)

description

string

Free-form text description for the transaction

amount

string

Amount being transfered

is_debit

string

True if the transaction is indentified as a debit in the API context

orig_account

string

Source account from which funds are withdrawn

orig_profile

string

Billing profile from which funds are withdrawn

orig_amount

integer

Amount withdrawn from source in orig_unit

orig_unit

string

Three-letter ISO 4217 code for source currency unit (ex: usd)

dest_account

string

Target account to which funds are deposited

dest_profile

string

Billing profile to which funds are deposited

dest_amount

integer

Amount deposited into target in dest_unit

dest_unit

string

Three-letter ISO 4217 code for target currency unit (ex: usd)

Examples

{
  "event": "order_executed",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "invoiced_items": [
    {
      "created_at": "2022-01-01T00:00:00Z",
      "description": "subscription to premium",
      "amount": 11900,
      "is_debit": false,
      "orig_account": "Receivable",
      "orig_profile": "djaoapp",
      "orig_amount": 11900,
      "orig_unit": "usd",
      "dest_account": "Payable",
      "dest_profile": "xia",
      "dest_amount": 11900,
      "dest_unit": "usd"
    }
  ],
  "provider": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  }
}

Error with processor setup

The processor returned an error when a user attempted to pay for a cart.

Definition

event

"processor_setup_error"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

detail

string

Examples

{
  "event": "processor_setup_error",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "detail": "There is no payment processor account connected.",
  "provider": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  }
}

Profile updated

This notification is sent when a profile is updated.

Definition

event

"profile_updated"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

changes

object

changes to the profile

Examples

{
  "event": "profile_updated",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "changes": {
    "full_name": {
      "pre": "Xia Lee",
      "post": "Xia Wang"
    }
  }
}

Renewal failed

This notification is sent when attempting to charge the credit card on file for renewal failed.

Definition

event

"renewal_charge_failed"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

charge_items

array

the line items on the charge receipt

invoiced

object

created_at

string

Date/time of creation (in ISO format)

description

string

Free-form text description for the transaction

amount

string

Amount being transfered

is_debit

string

True if the transaction is indentified as a debit in the API context

orig_account

string

Source account from which funds are withdrawn

orig_profile

string

Billing profile from which funds are withdrawn

orig_amount

integer

Amount withdrawn from source in orig_unit

orig_unit

string

Three-letter ISO 4217 code for source currency unit (ex: usd)

dest_account

string

Target account to which funds are deposited

dest_profile

string

Billing profile to which funds are deposited

dest_amount

integer

Amount deposited into target in dest_unit

dest_unit

string

Three-letter ISO 4217 code for target currency unit (ex: usd)

refunded

array

created_at

string

Date/time of creation (in ISO format)

description

string

Free-form text description for the transaction

amount

string

Amount being transfered

is_debit

string

True if the transaction is indentified as a debit in the API context

orig_account

string

Source account from which funds are withdrawn

orig_profile

string

Billing profile from which funds are withdrawn

orig_amount

integer

Amount withdrawn from source in orig_unit

orig_unit

string

Three-letter ISO 4217 code for source currency unit (ex: usd)

dest_account

string

Target account to which funds are deposited

dest_profile

string

Billing profile to which funds are deposited

dest_amount

integer

Amount deposited into target in dest_unit

dest_unit

string

Three-letter ISO 4217 code for target currency unit (ex: usd)

charge_total

object

Total amount for the charge

amount

integer

amount in unit

unit

string

Three-letter ISO 4217 code for currency unit (ex: usd)

nb_renewal_attempts

integer

number renewal attempts

max_renewal_attempts

integer

maximimum number of renewal attempts

final_notice

boolean

true if this is the final notice before subscription is canceled

Examples

{
  "event": "renewal_charge_failed",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "charge_total": {
    "amount": 11900,
    "unit": "usd"
  },
  "invoiced_items": [
    {
      "created_at": "2022-01-01T00:00:00Z",
      "description": "subscription to premium",
      "amount": 11900,
      "is_debit": false,
      "orig_account": "Receivable",
      "orig_profile": "djaoapp",
      "orig_amount": 11900,
      "orig_unit": "usd",
      "dest_account": "Payable",
      "dest_profile": "xia",
      "dest_amount": 11900,
      "dest_unit": "usd"
    }
  ],
  "nb_renewal_attempts": 1,
  "max_renewal_attempts": 3,
  "final_notice": false,
  "provider": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  }
}

Role grant accepted

This notification is sent when a user has accepted a role that was granted on a profile.

Definition

event

"role_grant_accepted"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

detail

string

optional message at the attention of the user

role_description

object

description of the role the notification is about

created_at

string

Date/time of creation (in ISO format)

slug

string

Unique identifier shown in the URL bar

title

string

Short description of the role. Grammatical rules to pluralize the title might be used in User Interfaces.

skip_optin_on_grant

boolean

Automatically grants the role without requiring a user to accept it.

implicit_create_on_none

boolean

Automatically adds the role when a user and profile share the same e-mail domain.

is_global

boolean

True when the role type is available for all profiles

profile

object

Profile the role type belongs to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

extra

string

Extra meta data (can be stringify JSON)

Examples

{
  "event": "role_grant_accepted",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "user": {
    "slug": "emilie",
    "username": "emilie",
    "printable_name": "Emilie",
    "full_name": "Emilie Jolie",
    "nick_name": "Emilie",
    "picture": null,
    "type": "user",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "",
    "email": "emilie@localhost.localdomain",
    "phone": "415-555-5557",
    "lang": "en",
    "extra": null
  },
  "role_description": {
    "slug": "manager",
    "title": "Managers"
  }
}

Role granted

This notification is sent when a user has been granted a role on a profile.

Definition

event

"role_grant_created"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

detail

string

optional message at the attention of the user

role_description

object

description of the role the notification is about

created_at

string

Date/time of creation (in ISO format)

slug

string

Unique identifier shown in the URL bar

title

string

Short description of the role. Grammatical rules to pluralize the title might be used in User Interfaces.

skip_optin_on_grant

boolean

Automatically grants the role without requiring a user to accept it.

implicit_create_on_none

boolean

Automatically adds the role when a user and profile share the same e-mail domain.

is_global

boolean

True when the role type is available for all profiles

profile

object

Profile the role type belongs to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

extra

string

Extra meta data (can be stringify JSON)

Examples

{
  "event": "role_grant_created",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "user": {
    "slug": "emilie",
    "username": "emilie",
    "printable_name": "Emilie",
    "full_name": "Emilie Jolie",
    "nick_name": "Emilie",
    "picture": null,
    "type": "user",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "",
    "email": "emilie@localhost.localdomain",
    "phone": "415-555-5557",
    "lang": "en",
    "extra": null
  },
  "role_description": {
    "slug": "manager",
    "title": "Managers"
  }
}

Role requested

This notification is sent when a user has requested a role on a profile.

Definition

event

"role_request_created"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

detail

string

optional message at the attention of the user

Examples

{
  "event": "role_request_created",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "user": {
    "slug": "emilie",
    "username": "emilie",
    "printable_name": "Emilie",
    "full_name": "Emilie Jolie",
    "nick_name": "Emilie",
    "picture": null,
    "type": "user",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "",
    "email": "emilie@localhost.localdomain",
    "phone": "415-555-5557",
    "lang": "en",
    "extra": null
  }
}

Subscription grant accepted

This notification is sent when a profile has accepted a subscription that was previously granted.

Definition

event

"subscription_grant_accepted"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

plan

object

plan the subscription relates to

slug

string

Unique identifier shown in the URL bar

title

string

Title for the plan

Examples

{
  "event": "subscription_grant_accepted",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "plan": {
    "slug": "premium",
    "title": "Premium"
  }
}

Subscription granted

This notification is sent when a profile is granted a subscription to a plan.

Definition

event

"subscription_grant_created"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

plan

object

plan the subscription relates to

slug

string

Unique identifier shown in the URL bar

title

string

Title for the plan

detail

string

optional message at the attention of the profile

Examples

{
  "event": "subscription_grant_created",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "plan": {
    "slug": "premium",
    "title": "Premium"
  }
}

Subscription request accepted

This notification is sent when a provider accepts to grant a subscription a profile previously requested.

Definition

event

"subscription_request_accepted"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

plan

object

plan the subscription relates to

slug

string

Unique identifier shown in the URL bar

title

string

Title for the plan

Examples

{
  "event": "subscription_request_accepted",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "plan": {
    "slug": "premium",
    "title": "Premium"
  }
}

Subscription requested

This notification is sent when a profile is requesting a subscription to a plan.

Definition

event

"subscription_request_created"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

plan

object

plan the subscription relates to

slug

string

Unique identifier shown in the URL bar

title

string

Title for the plan

detail

string

optional message at the attention of the profile

Examples

{
  "event": "subscription_request_created",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "plan": {
    "slug": "premium",
    "title": "Premium"
  }
}

User activated

This notification is sent when a user has activated his/her account.

Definition

event

"user_activated"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

Examples

{
  "event": "user_activated",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "user": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  }
}

Contact us

Someone requested information through the contact form.

Definition

event

"user_contact"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

originated_by

object

the user at the origin of the notification

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

detail

string

message written in the contact us form

provider

object

provider when different from broker

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

Examples

{
  "event": "user_contact",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "originated_by": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "detail": "Please help!"
}

One-time code generated

A one-time code was generated for Multi-factor authentication (MFA).

Definition

event

"user_mfa_code"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

nb_expiration_days

integer

number of days the link is valid

code

integer

one-time code

Examples

{
  "event": "user_mfa_code",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/activate/abcdef123/",
  "user": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "nb_expiration_days": 2,
  "code": "1234"
}

User registered

This notification is sent when a user has registered.

Definition

event

"user_registered"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

Examples

{
  "event": "user_registered",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "user": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  }
}

Password reset

This notification is sent to a user that has requested to reset their password through a "forgot password?" link.

Definition

event

"user_reset_password"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

nb_expiration_days

integer

number of days the link is valid

Examples

{
  "event": "user_verification",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/activate/abcdef123/",
  "user": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "nb_expiration_days": 2
}

Verification of e-mail address

This notification is sent to verify an e-mail address of a user.

Definition

event

"user_verification"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

user

object

user the notification applies to

slug

string

Username

username

string

Username

printable_name

string

Name that can be safely used for display in HTML pages

created_at

string

date at which the account was created

picture

string

URL location of the profile picture

string

Primary e-mail to contact user

credentials

boolean

True if the user has valid login credentials

last_login

string

phone

string

Primary phone number to contact user

full_name

string

Full name (effectively first name followed by last name)

nick_name

string

Short casual name used to address the user

lang

string

Preferred communication language

nb_expiration_days

integer

number of days the link is valid

Examples

{
  "event": "user_verification",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/activate/abcdef123/",
  "user": {
    "slug": "xia",
    "username": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "last_login": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "lang": "en",
    "extra": null
  },
  "nb_expiration_days": 2
}

Weekly sales report

This notification contains the weekly sales results.

Definition

event

"weekly_sales_report_created"

broker

object

Site on which the product is hosted

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

back_url

string

Link back to the site

profile

object

profile the notification relates to

slug

string

Unique identifier shown in the URL bar

printable_name

string

Name that can be safely used for display in HTML pages

picture

string

URL location of the profile picture

type

string

One of 'organization', 'personal' or 'user'

credentials

boolean

True if the account has valid login credentials

full_name

string

Full name

created_at

string

Date/time of creation (in ISO format)

string

E-mail address

phone

string

Phone number

street_address

string

Street address

locality

string

City/Town

region

string

State/Province/County

postal_code

string

Zip/Postal code

country

string

Country

default_timezone

string

Timezone to use when reporting metrics

is_provider

boolean

The profile can fulfill the provider side of a subscription.

is_bulk_buyer

boolean

Enable GroupBuy

extra

string

Extra meta data (can be stringify JSON)

detail

string

Describes the result of the action in human-readable form

nick_name

string

Short casual name used to address the contact (only available for 'personal' and 'user' accounts)

lang

string

Preferred communication language (only available for 'personal' and 'user' accounts)

table

string

date

string

Examples

{
  "event": "weekly_sales_report_created",
  "broker": {
    "slug": "djaoapp",
    "printable_name": "DjaoApp",
    "full_name": "DjaoApp inc.",
    "nick_name": "DjaoApp",
    "picture": null,
    "type": "organization",
    "credentials": false,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "djaoapp@localhost.localdomain",
    "phone": "415-555-5555",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": true,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "back_url": "https://example.djaoapp.com/",
  "profile": {
    "slug": "xia",
    "printable_name": "Xia",
    "full_name": "Xia Lee",
    "nick_name": "Xia",
    "picture": null,
    "type": "personal",
    "credentials": true,
    "created_at": "2022-01-01T00:00:00Z",
    "email": "xia@localhost.localdomain",
    "phone": "415-555-5556",
    "street_address": "1 SaaS Road",
    "locality": "San Francisco",
    "region": "California",
    "postal_code": "94133",
    "country": "US",
    "default_timezone": "America/Los_Angeles",
    "is_provider": false,
    "is_bulk_buyer": false,
    "lang": "en",
    "extra": null
  },
  "table": [],
  "date": "2022-01-07T00:00:00Z"
}