Zapier app endpoints
Get one Zapier event
Available only to the official Jointl Zapier app.
Retrieve the full payload for one opaque event notification through the member’s current Jointl permissions.
Use when: Use only after an instant Zapier hook receives an event ID. Returns: one authorized trigger payload; revoked or inaccessible records are not returned.
POST
https://api.join.tl
/
api
/
v1
/
operations
/
events.get
Get one Zapier event
curl --request POST \
--url https://api.join.tl/api/v1/operations/events.get \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"eventId": "eventid_example_01"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({eventId: 'eventid_example_01'})
};
fetch('https://api.join.tl/api/v1/operations/events.get', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.join.tl/api/v1/operations/events.get"
payload = { "eventId": "eventid_example_01" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"check_id": "check_example_01",
"company_ids": [
"company_example_01"
],
"data": {
"id": "check_example_01",
"status": "new"
},
"entity_id": "check_example_01",
"entity_type": "check",
"event_type": "check.created",
"id": "event_example_01",
"jointl_url": "https://join.tl/checks/check_example_01",
"occurred_at": "2026-01-15T10:30:00.000Z",
"record_name": "Ada Example"
},
"requestId": "request_example_01"
}{
"error": {
"code": "invalid-external-operation-input",
"message": "The operation input is invalid."
},
"requestId": "request_example_400"
}{
"error": {
"code": "not-authenticated",
"message": "Authentication is required."
},
"requestId": "request_example_401"
}{
"error": {
"code": "not-authorized",
"message": "You are not allowed to perform this action."
},
"requestId": "request_example_403"
}{
"error": {
"code": "not-found",
"message": "The requested record was not found."
},
"requestId": "request_example_404"
}{
"error": {
"code": "external-action-conflict",
"message": "The action conflicts with current state."
},
"requestId": "request_example_409"
}{
"error": {
"code": "request-too-large",
"message": "The request body is too large."
},
"requestId": "request_example_413"
}{
"error": {
"code": "too-many-requests",
"message": "Too many requests."
},
"requestId": "request_example_429"
}{
"error": {
"code": "internal-error",
"message": "The request could not be completed."
},
"requestId": "request_example_500"
}{
"error": {
"code": "temporarily-unavailable",
"message": "The service is temporarily unavailable."
},
"requestId": "request_example_503"
}⌘I
Get one Zapier event
curl --request POST \
--url https://api.join.tl/api/v1/operations/events.get \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"eventId": "eventid_example_01"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({eventId: 'eventid_example_01'})
};
fetch('https://api.join.tl/api/v1/operations/events.get', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.join.tl/api/v1/operations/events.get"
payload = { "eventId": "eventid_example_01" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"check_id": "check_example_01",
"company_ids": [
"company_example_01"
],
"data": {
"id": "check_example_01",
"status": "new"
},
"entity_id": "check_example_01",
"entity_type": "check",
"event_type": "check.created",
"id": "event_example_01",
"jointl_url": "https://join.tl/checks/check_example_01",
"occurred_at": "2026-01-15T10:30:00.000Z",
"record_name": "Ada Example"
},
"requestId": "request_example_01"
}{
"error": {
"code": "invalid-external-operation-input",
"message": "The operation input is invalid."
},
"requestId": "request_example_400"
}{
"error": {
"code": "not-authenticated",
"message": "Authentication is required."
},
"requestId": "request_example_401"
}{
"error": {
"code": "not-authorized",
"message": "You are not allowed to perform this action."
},
"requestId": "request_example_403"
}{
"error": {
"code": "not-found",
"message": "The requested record was not found."
},
"requestId": "request_example_404"
}{
"error": {
"code": "external-action-conflict",
"message": "The action conflicts with current state."
},
"requestId": "request_example_409"
}{
"error": {
"code": "request-too-large",
"message": "The request body is too large."
},
"requestId": "request_example_413"
}{
"error": {
"code": "too-many-requests",
"message": "Too many requests."
},
"requestId": "request_example_429"
}{
"error": {
"code": "internal-error",
"message": "The request could not be completed."
},
"requestId": "request_example_500"
}{
"error": {
"code": "temporarily-unavailable",
"message": "The service is temporarily unavailable."
},
"requestId": "request_example_503"
}