Link Contacts to a Deal

POST https://app.alaaqat.com/api/deals/{deal_id}/attach-contacts

Where deal_id is the deal's _id. Links one or more contacts to the deal. Contacts that are already linked stay linked. Your API key needs the deal-update ability.

To link contacts while you create the deal, send contact_ids to Create a Deal instead.

Header

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

Body

{
    contact_ids: string[]
}
Field Required Validation Description
contact_ids Required An array of contact IDs from your account The contacts to link to the deal. 
{
    "contact_ids": [
        "6650f1a2b3c4d5e6f7a8b901",
        "6650f1a2b3c4d5e6f7a8b902"
    ]
}

Response

200 OK, with every contact now linked to the deal under data.

{
    "data": [
        {
            "properties": {
                "_id": "6650f1a2b3c4d5e6f7a8b901",
                "account_id": 1024,
                "firstname": "Layla",
                "lastname": "Nasser",
                "email": "layla.nasser@example.com",
                "created_at": "2026-10-20T09:30:00.000000Z",
                "fullname": "Layla Nasser",
                "image": null
            },
            "channels": []
        },
        {
            "properties": {
                "_id": "6650f1a2b3c4d5e6f7a8b902",
                "account_id": 1024,
                "firstname": "Omar",
                "lastname": "Khalil",
                "email": "omar.khalil@example.com",
                "created_at": "2026-10-15T16:10:00.000000Z",
                "fullname": "Omar Khalil",
                "image": null
            },
            "channels": []
        }
    ]
}


Unlink a Contact from a Deal

POST https://app.alaaqat.com/api/deals/{deal_id}/detach-contact

Where deal_id is the deal's _id. Removes the link between the deal and one contact. Neither record is deleted. Your API key needs the deal-update ability.

Header

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

Body

{
    contact_id: string
}
Field Required Validation Description
contact_id Required The ID of one of your contacts The contact to unlink from the deal. 
{
    "contact_id": "6650f1a2b3c4d5e6f7a8b902"
}

Response

200 OK, with the deal under data.

{
    "data": {
        "properties": {
            "_id": "6651a0b1c2d3e4f5a6b7c801",
            "deal_name": "Annual support contract",
            "amount": 1200,
            "deal_stage": "appointment_scheduled",
            "created_by": 12,
            "updated_at": "2026-10-21T10:15:00.000000Z",
            "created_at": "2026-10-20T10:05:00.000000Z"
        }
    },
    "message": "Entity was modified successfully."
}