associations.updated

Crewsum sends associations.updated when a project-contact association is changed.

Event type

associations.updated

When it is sent

• The Update Association API endpoint (PUT /v1/associations/associations/:id).
• Changing a contact’s role or notification level on a project in the Crewsum app.

Crewsum sends the event only after the change is saved. A request that fails or is rejected sends no event. See Delivery for timing and retries.

Payload

data.associations is an array. Each item has the project, the contact, and the association as it is after the change.

{
  "event": "associations.updated",
  "data": {
    "associations": [
      {
        "project": {
          "id": "project-mno123pqr4567890",
          "name": "Warehouse Automation Rollout",
          "description": "Conveyor and scanner installation",
          "isArchived": false,
          "createdAt": "2026-09-28T14:05:12.000Z",
          "updatedAt": "2026-09-28T14:05:12.000Z",
          "isDeleted": false,
          "clientId": "client-ghi123jkl4567890",
          "clientName": "Northwind Logistics",
          "clientDeleted": false,
          "clientArchived": false,
          "endCustomerId": "endcustomer-abc123def4567890",
          "endCustomerName": "Bayview Distribution Center",
          "endCustomerDeleted": false,
          "endCustomerArchived": false,
          "hoursBudget": 400,
          "submittedHours": 0,
          "billingCategory": "BILLABLE",
          "completed": false,
          "autoAssign": false,
          "customFields": {
            "poNumber": "PO-1042"
          },
          "clientCustomFields": {
            "region": "West"
          }
        },
        "contact": {
          "id": "contact-jkl123mno4567890",
          "name": "Dana Whitfield",
          "description": "Operations manager",
          "isArchived": false,
          "createdAt": "2026-09-28T14:05:12.000Z",
          "updatedAt": "2026-09-28T14:05:12.000Z",
          "isDeleted": false,
          "clientId": "client-ghi123jkl4567890",
          "clientName": "Northwind Logistics",
          "clientArchived": false,
          "clientDeleted": false,
          "email": "dana.whitfield@example.com",
          "type": "EXTERNAL",
          "userId": null,
          "hasPortalAccess": true
        },
        "association": {
          "projectId": "project-mno123pqr4567890",
          "projectName": "Warehouse Automation Rollout",
          "projectEndCustomer": "Bayview Distribution Center",
          "contactId": "contact-jkl123mno4567890",
          "contactName": "Dana Whitfield",
          "contactType": "BACKUP_MANAGER",
          "notificationLevel": "COPY_ONLY"
        }
      }
    ]
  }
}

contactType is MANAGER, BACKUP_MANAGER, or ADDITIONAL_CONTACT. notificationLevel is COPY_ONLY, COPY_WITH_LINK, or NONE.

Related API calls

Update Association

Get Association