User Forms Webhooks
Sent when user form events occur.
User forms are response forms (see Step 4) that users can submit as a fallback when they cannot find their employer or payroll provider.
#Submitted
The user_forms.submitted webhook is sent when a response form is submitted.
- #eventsarray of stringsrequired
user_forms.submitted - #namestringrequired
Your name for the webhook subscription.
- #urlstringrequired
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.
- #secretstringoptional
Optional secret used to verify webhooks.
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 }'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
The user_forms.removed webhook is only sent when an account is deleted.
- #eventsarray of stringsrequired
user_forms.removed - #namestringrequired
Your name for the webhook subscription.
- #urlstringrequired
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.
- #secretstringoptional
Optional secret used to verify webhooks.
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 }'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}