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

  • Unix seconds. Reject requests outside the receiver replay window.

  • v1= followed by HMAC-SHA256 of timestamp + dot + exact JSON body.

Body

required
application/json
  • the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • values
    • project-created
    • project-updated
    • design-help-started
    • design-help-ended
    • proposal-sent
    • contract-sent
    • contract-signed
    • contract-change-order-sent
  • Properties: 3
  • Sent only with contract-signed, when the signed contract PDF is available.

    Properties: 1

Responses

  • 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