Webhook
Receive a webhook event
Artemis sends this request to your subscription’s callback URL. Verify the signature against the exact request body, deduplicate by event ID, and fetch resource.href for the current project or user. contract-signed also includes data.contractUrl, a 24-hour link to the signed contract PDF. Deleted users may no longer be fetchable. Deliveries may repeat or arrive out of order.
Headers
- Type: stringFormat: uuidX
- Artemis - Webhook - Id required - Type: stringX
- Artemis - Webhook - Timestamp requiredUnix seconds. Reject requests outside the receiver replay window.
- Type: stringX
- Artemis - Webhook - Signature requiredv1= followed by HMAC-SHA256 of timestamp + dot + exact JSON body.
Body
required
application/json
- Type: stringFormat: date-timecreated
At requiredthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- Type: stringenumeventrequiredvalues
- project
-created - project
-updated - design
-help -started - design
-help -ended - proposal
-sent - contract
-sent - contract
-signed - contract
-change -order -sent
- project
- Type: stringFormat: uuididrequired
- Properties: 3Type: objectresourcerequired
- versionconst:2required
- Type: objectdataProperties: 1
Sent only with
contract-signed, when the signed contract PDF is available.
Responses
- 200
Accepted. Deduplicate by event ID.
Request Example for postprojectChanged
{
"id": "fbb6598b-4f41-4d91-ae62-2280295134ad",
"event": "project-created",
"version": 2,
"createdAt": "2026-09-05T12:00:00.000Z",
"resource": {
"type": "project",
"id": "a318dac7-99eb-4c38-8c78-5b2c15bf93b0",
"href": "/external/v2/projects/a318dac7-99eb-4c38-8c78-5b2c15bf93b0"
}
}
No Body

