associations.created

Crewsum sends associations.created when a contact is linked to a project.

Event type

associations.created

When it is sent

• The Create Association API endpoint (POST /v1/associations/associations).
• Linking a contact to a project in the Crewsum app: from the project, from the contact, or while you create or edit a client, project, or contact. One event can contain several associations.

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 (without its associations list), the contact (without its associations and supplierAssociations lists), and the association itself.

{
  "event": "associations.created",
  "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": "MANAGER",
          "notificationLevel": "COPY_WITH_LINK"
        }
      }
    ]
  }
}

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

Related API calls

Create Association

Get Association