API Reference
Log inSign up
v1.7.3
v1.7.3
  • ComplyCube API Reference
  • Integration
  • Test and Live
  • Authentication
  • Rate Limits
  • Service Quota
  • Errors
  • Pagination
  • Filtering
  • Versioning
  • Core resources
    • Clients
      • Create a client
      • Get a client
      • Update a client
      • Delete a client
      • List clients
      • Filtering clients
    • Addresses
      • Create an address
      • Get an address
      • Update an address
      • Delete an address
      • List addresses
      • Filtering addresses
    • Documents
      • Create a document
      • Get a document
      • Update a document
      • Upload image attachment
      • Delete image attachment
      • Download image attachment
      • Redact image attachment
      • Delete a document
      • List documents
      • Filtering documents
    • Live Photos
      • Upload a live photo
      • Get a live photo
      • Download live photo
      • Redact live photo
      • Delete a live photo
      • List live photos
    • Live Videos
      • Get a live video
      • Redact live video
      • Delete live video
      • List live videos
    • Checks
      • Create a check
      • Get a check
      • Update a check
      • Validate check outcome
      • Redact check outcome
      • List checks
      • Filtering checks
    • Risk Profile
      • Get a risk profile
  • Check types
    • AML Screening Check
    • Document Check
    • Identity Check
    • Enhanced Identity Check
    • Proof of Address Check
    • Multi-Bureau Check
    • Face Authentication Check
    • Age Estimation Check
  • Lookups
    • Company Search
      • Search company
      • Get company details
    • Address Search
      • Search address
  • Tools
    • Custom Lists
      • Get a custom list
      • Add entity to custom list
      • List custom lists
  • Static Data
    • Screening Lists
    • Supported Documents
  • Other Resources
    • Flow (Hosted Solution)
      • Create a session
    • Webhooks
      • Create a webhook
      • Get a webhook
      • Update a webhook
      • Delete a webhook
      • List webhooks
      • Filtering webhooks
    • SDK Tokens
      • Generate a token
    • Autofill
      • Perform autofill
    • Reports
      • Generate a client report
      • Generate a check report
    • Team Members
      • Get a team member
      • List team members
      • Filtering team members
    • Audit Logs
      • Get an audit log
      • List audit logs
      • Filtering audit logs
    • Account Info
      • Get account info
  • Useful Resources
    • Testing Data
    • User Docs
Powered by GitBook
On this page
  • The Webhook object
  • Event Types
  • The Event Object

Was this helpful?

  1. Other Resources

Webhooks

Use the features of ComplyCube Webhooks to set up real-time notifications.

PreviousCreate a sessionNextCreate a webhook

Last updated 1 year ago

Was this helpful?

ComplyCube uses to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a has concluded.

You can configure webhook endpoints via the API or the Web Portal to be notified about events that happen in your ComplyCube account and related resources.

Upon receiving a webhook notification, you should acknowledge success by responding with an HTTP 20x response within 15 seconds. Otherwise, we will attempt to resend the notification up to 10 times according to an exponential back-off schedule.

The first attempt will be made 60 seconds after the initial attempt; the second attempt will be made 120 seconds later; the third attempt will be made 480 seconds later, and so forth until all 10 attempts are exhausted. After which, the corresponding webhook will be disabled.

You can quickly inspect webhook events with temporary endpoint URLs using free hosted services such as https://webhook.site.

The Webhook object

Attribute
Type
Description

id

string

The unique identifier for the webhook.

description

string

A description of what the webhook is used for.

url

string

The URL of the webhook endpoint - must be HTTPS.

enabled

boolean

Determines if the webhook should be active.

events

array[string]

secret

string

createdAt

string

The date and time when the webhook was created.

updatedAt

string

The date and time when the webhook was updated.

Event Types

Event
Description

check.pending

A check has been created and is in pending state.

check.completed

A check has completed with any outcome.

check.completed.clear

A check has completed with clear outcome.

check.completed.attention

A check has completed with attention outcome.

check.completed.rejected

A check has completed with rejected outcome.

check.completed.match_confirmed

A check has completed with match_confirmed outcome.

check.monitoring.attention

A monitoring check has completed with attention outcome.

check.failed

A check has failed.

check.updated

A check has been updated.

client.created

A client has been created.

client.updated

A client has been updated.

client.deleted

A client has been deleted.

document.created

A document has been created.

document.updated

A document has been updated.

document.updated.image_uploaded

A document has been updated with a new image.

document.updated.image_deleted

A document has been updated as an image has been deleted.

document.deleted

A document has been deleted.

address.created

An address has been created.

address.updated

An address has been updated.

address.deleted

An address has been deleted.

The Event Object

Attribute
Type
Description

id

string

The unique identifier for the event, which a webhook listener can use to bypass notification processing on a webhook notification sent more than once.

type

string

resourceType

string

payload

object

createdAt

string

The date and time when the webhook was created.

{
  "id": "5ed170fe99c81a0007b9a3d3",
  "type": "check.completed.clear",
  "resourceType": "check",
  "payload": {
    "id": "5ed3918fbf06f30008e552c9",
    "outcome": "clear",
    "status": "complete",
    "createdAt": "2020-01-01T11:14:23.964Z",
    "updatedAt": "2020-01-01T11:14:23.964Z"
  },
  "createdAt": "2020-01-01T11:14:23.964Z"
}

Payload by resource type

Type
Payload
  • On create: the full object of the corresponding resource.

  • On update: id of the object along with updated fields.

  • On delete: id of the deleted object.

  • On create: the full object of the corresponding resource.

  • On update: id of the object along with updated fields.

  • On other events:

    • id: The unique identifier for the check.

    • status: The status of the check.

    • outcome: The outcome of the check. Only returned when the status is complete.

    • createdAt: The date and time when the check was created.

    • updatedAt: The date and time when the check was updated.

The list of enabled for this webhook. ["*"] indicates that all events will be published.

The endpoint’s secret used to generate signatures. Only returned at creation.

The that initiated the event.

The type of the object contained within the payload, e.g. object.

The key attributes of the object associated with this event. Also, see the table below.

webhooks
check
Learn more about ComplyCube Webhooks
➔
webhook
check
clients
documents
addresses
livePhotos
checks
event types
event type
payload by resource type