User Forms Webhooks

Sent when user form events occur.

User forms can come from two sources:

  • Document uploads.
  • Response forms when users cannot find their employer or payroll provider.

#Submitted

post/v2/webhooks

The user_forms.submitted webhook is sent:

  • When a response form is submitted.
  • When an initial set of uploaded documents are submitted for the first time.
  • Each time an additional document is uploaded beyond the initial set of uploaded documents.
Request body
  • #
    eventsarray of strings
    required

    user_forms.submitted

  • #
    namestring
    required

    Your name for the webhook subscription.

  • #
    urlstring
    required

    Where you want to receive webhook delivery. This can be either a backend URL that you manage, or a URL provided by a webhook management service.

  • #
    secretstring
    optional

    Optional secret used to verify webhooks.

Webhook message
  • #
    eventstring

    user_forms.submitted

  • #
    namestring

    Name used for the webhook subscription.

  • #
    dataobject

  • #
    accountstring (uuid)

    ID of the account.

  • #
    userstring (uuid)

    ID of the user.

  • #
    user_formstring (uuid)

    ID of the user form.

Example Subscription
1curl --request POST \
2     --url https://api.argyle.com/v2/webhooks \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json' \
5     --data '{
6        "events": ["user_forms.submitted"],
7        "name": "name-for-the-webhook-subscription",
8        "url": "https://your-webhook-backend.com",
9        "secret": "optional-secret"
10     }'
Example Webhook
1{
2  "event": "user_forms.submitted",
3  "name": "name-for-the-webhook-subscription",
4  "data": {
5    "account": "01856c65-43b6-8b5d-b32a-56b8fbda5c28",
6    "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
7    "user_form": "0187bf23-cd80-118d-c0b8-58023e21c8e5"
8  }
9}

#Removed

post/v2/webhooks

The user_forms.removed webhook is sent when a user returns to Link and deletes their previously uploaded documents, or when an account is deleted entirely.

Request body
  • #
    eventsarray of strings
    required

    user_forms.removed

  • #
    namestring
    required

    Your name for the webhook subscription.

  • #
    urlstring
    required

    Where you want to receive webhook delivery. This can be either a backend URL that you manage, or a URL provided by a webhook management service.

  • #
    secretstring
    optional

    Optional secret used to verify webhooks.

Webhook message
  • #
    eventstring

    user_forms.removed

  • #
    namestring

    Name used for the webhook subscription.

  • #
    dataobject

  • #
    accountstring (uuid)

    ID of the account.

  • #
    userstring (uuid)

    ID of the user.

  • #
    user_formstring (uuid)

    ID of the user form.

Example Subscription
1curl --request POST \
2     --url https://api.argyle.com/v2/webhooks \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json' \
5     --data '{
6        "events": ["user_forms.removed"],
7        "name": "name-for-the-webhook-subscription",
8        "url": "https://your-webhook-backend.com",
9        "secret": "optional-secret"
10     }'
Example Webhook
1{
2  "event": "user_forms.removed",
3  "name": "name-for-the-webhook-subscription",
4  "data": {
5    "account": "01856c65-43b6-8b5d-b32a-56b8fbda5c28",
6    "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
7    "user_form": "0187bf23-cd80-118d-c0b8-58023e21c8e5"
8  }
9}

#OCR completed

post/v2/webhooks

The user_forms.ocr_completed webhook is sent when third party OCR data is available for an uploaded document.

If multiple documents are submitted at the same time, this webhook is sent if third party OCR has successfully completed for at least one uploaded document. If any third party OCR errors occurred for the remaining uploaded documents, they will be listed in the ocr_data object of the user forms object in an error field.

Request body
  • #
    eventsarray of strings
    required

    user_forms.ocr_completed

  • #
    namestring
    required

    Your name for the webhook subscription.

  • #
    urlstring
    required

    Where you want to receive webhook delivery. This can be either a backend URL that you manage, or a URL provided by a webhook management service.

  • #
    secretstring
    optional

    Optional secret used to verify webhooks.

Webhook message
  • #
    eventstring

    user_forms.ocr_completed

  • #
    namestring

    Name used for the webhook subscription.

  • #
    dataobject

  • #
    accountstring (uuid)

    ID of the account.

  • #
    userstring (uuid)

    ID of the user.

  • #
    user_formstring (uuid)

    ID of the user form.

Example Subscription
1curl --request POST \
2     --url https://api.argyle.com/v2/webhooks \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json' \
5     --data '{
6        "events": ["user_forms.ocr_completed"],
7        "name": "name-for-the-webhook-subscription",
8        "url": "https://your-webhook-backend.com",
9        "secret": "optional-secret"
10     }'
Example Webhook
1{
2  "event": "user_forms.ocr_completed",
3  "name": "name-for-the-webhook-subscription",
4  "data": {
5    "account": "01856c65-43b6-8b5d-b32a-56b8fbda5c28",
6    "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
7    "user_form": "0187bf23-cd80-118d-c0b8-58023e21c8e5"
8  }
9}

#OCR failed

post/v2/webhooks

The user_forms.ocr_failed webhook is sent when third party OCR processing could not be completed for all uploaded documents in a single user form submission.

Third party OCR errors are returned in the ocr_data object of the user forms object in an error field.

Request body
  • #
    eventsarray of strings
    required

    user_forms.ocr_failed

  • #
    namestring
    required

    Your name for the webhook subscription.

  • #
    urlstring
    required

    Where you want to receive webhook delivery. This can be either a backend URL that you manage, or a URL provided by a webhook management service.

  • #
    secretstring
    optional

    Optional secret used to verify webhooks.

Webhook message
  • #
    eventstring

    user_forms.ocr_failed

  • #
    namestring

    Name used for the webhook subscription.

  • #
    dataobject

  • #
    accountstring (uuid)

    ID of the account.

  • #
    userstring (uuid)

    ID of the user.

  • #
    user_formstring (uuid)

    ID of the user form.

Example Subscription
1curl --request POST \
2     --url https://api.argyle.com/v2/webhooks \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json' \
5     --data '{
6        "events": ["user_forms.ocr_failed"],
7        "name": "name-for-the-webhook-subscription",
8        "url": "https://your-webhook-backend.com",
9        "secret": "optional-secret"
10     }'
Example Webhook
1{
2  "event": "user_forms.ocr_failed",
3  "name": "name-for-the-webhook-subscription",
4  "data": {
5    "account": "01856c65-43b6-8b5d-b32a-56b8fbda5c28",
6    "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
7    "user_form": "0187bf23-cd80-118d-c0b8-58023e21c8e5"
8  }
9}

#OCR authenticity

post/v2/webhooks

The user_forms.ocr_authenticity webhook is sent when third party OCR authenticity information is available for an uploaded document.

Request body
  • #
    eventsarray of strings
    required

    user_forms.ocr_authenticity

  • #
    namestring
    required

    Your name for the webhook subscription.

  • #
    urlstring
    required

    Where you want to receive webhook delivery. This can be either a backend URL that you manage, or a URL provided by a webhook management service.

  • #
    secretstring
    optional

    Optional secret used to verify webhooks.

Webhook message
  • #
    eventstring

    user_forms.ocr_authenticity

  • #
    namestring

    Name used for the webhook subscription.

  • #
    dataobject

  • #
    accountstring (uuid)

    ID of the account.

  • #
    userstring (uuid)

    ID of the user.

  • #
    user_formstring (uuid)

    ID of the user form.

Example Subscription
1curl --request POST \
2     --url https://api.argyle.com/v2/webhooks \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json' \
5     --data '{
6        "events": ["user_forms.ocr_authenticity"],
7        "name": "name-for-the-webhook-subscription",
8        "url": "https://your-webhook-backend.com",
9        "secret": "optional-secret"
10     }'
Example Webhook
1{
2  "event": "user_forms.ocr_authenticity",
3  "name": "name-for-the-webhook-subscription",
4  "data": {
5    "account": "01856c65-43b6-8b5d-b32a-56b8fbda5c28",
6    "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
7    "user_form": "0187bf23-cd80-118d-c0b8-58023e21c8e5"
8  }
9}
Updating Argyle status...
┬ę 2024 Argyle Systems Inc.argyle.com