Events

Axle’s Ignition session is the main interface that allows your users to connect to their insurance accounts and authorize access to scoped data from their insurance policies.

Please first review the Quickstart guide and API docs on how to start an Ignition session, if you have not already.

​

Configure an Ignition session for event handling

Your POST request to /ignition can include the following request body:

• Optional: redirectUri - the URL Axle Ignition will redirect the user to upon completion, exit, or error outcomes of the Ignition session, defaults to no redirect
• Optional: webhookUri - the URL Axle will send events to as the user proceeds through the Ignition session, defaults to no webhook events
• Optional: user - optional user to attach, please refer to startIgnition for more details
• Optional: metadata - optional Ignition session metadata, please refer to startIgnition for more details

curl --request POST \
  --url https://api.axle.insure/ignition \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: cli_mZj6YGXhQyQnccN97aXbq' \
  --header 'x-client-secret: RZM-5BErZuChKqycbCS1O' \
  --data '{
  "redirectUri": "https://example.com/insurance/redirect",
  "webhookUri": "https://example.com/insurance/webhook"
}

​

Redirect and Window MessageEvent parameters

On Ignition status change, the following parameters will be shared via URL to the redirectUri provided and in the Window MessageEvent.

status: String

• complete
• exit
• error

Additional parameters (dependent on status, see below)

• authCode: String - authorization code that can be exchange for accessToken for scoped access to connected account and/or policy
• client: String - the client ID associated with the session. This is primarily useful for platforms who have multiple clients. See the Axle for Platforms guide for more information about platforms.
• result: String - “link” (account connection was made and policy is available) OR “basic” (account connection was made but policy details are not available) OR “manual” (policy details were entered through manual collection form)
• step: String - the step where the Ignition session was exited
• message: String - additional information about the Ignition session error

  https://example.com/insurance/redirect?status=complete&authCode=cod_LwPJhgxnjinMEPfGYc-XV&client=cli_mZj6YGXhQyQnccN97aXbq&result=link

​

onComplete

When the user successfully connects to their carrier account and shares authorized access to a selected policy, OR when the user submits their policy information and/or documentation through Axle’s manual collection form.

{
  "status": "complete",
  "authCode": "<authCode>",
  "client": "<client-id>",
  "result": "link" || "basic" || "manual"
}

​

onExit

When the user opts out of connecting to their carrier account and/or selecting a policy, OR when the user opts out of sharing the requested policy information and/or documentation.

{
  "status": "exit",
  "step": "<step-name>",
  "client": "<client-id>"
}

​

onError

When Axle is unable to retrieve account or policy information from a selected carrier, OR when Axle is unable to collect policy information and/or documentation from the user.

{
  "status": "error",
  "message": "<message-body>",
  "client": "<client-id>"
}

​

Webhooks

If an optional webhookUri is provided, a POST request will be sent to the webhookUri with the following payload. The individual parameters included within data are the same as those listed above for the corresponding status, with the addition of user and metadata shared via the Ignition request body:

{
  "id": "<event_id>",
  "type": "ignition.completed",
  "data": {
    "client": "<client-id>",
    "token": "ign_Z4ni-JHBvkn9PlKJHPEwk",
    ...{ parameters }
  },
  "createdAt": "2022-10-05T14:48:00.000Z"
}