Push out data with Webhooks

You can send information from Closer to your application via Webhooks. If you're new to webhooks, read this guide to learn more.

Rather than requiring you to pull information via our API, webhooks will push information to your endpoint. When one of those events is triggered (for example a new deal is added), Pipedrive will send this notification as an HTTP POST request, with a JSON body, to the endpoint(s) you specify.

To configure endpoint(s) for the webhooks to be sent to, head to the Admin / Webhooks section.

We support 2 types of events: conversation.created and conversation.closed.

Webhook format

conversation.created event

{
  "customer": {
    "id": "00000000-0000-0000-0000-000000000000",
    "apiKey": "00000000-0000-0000-0000-000000000000",
    "firstName": "Jon",
    "lastName": "Snow",
    "randomName": "Frosty Wolf",
    "backOfficeData": [
      {
        "key": "currentPage",
        "value": "https://yourbusiness.com/"
      },
      {
        "key": "currentPageTitle",
        "value": "Your business"
      },
      {
        "key": "screenSize",
        "value": "1080x1920"
      },
      {
        "key": "browserVersion",
        "value": "67"
      },
      {
        "key": "browserName",
        "value": "Firefox"
      },
      {
        "key": "operatingSystem",
        "value": "Mac OS X 10.14"
      }
    ]
  },
    "email": "[e-mail]",
    "phone": "[phone]"
  },
  "timestamp": 1560499664789,
  "eventType": "ThreadCreatedEvent"
}

conversation.closed event

{
  "customer": {
    "id": "00000000-0000-0000-0000-000000000000",
    "apiKey": "00000000-0000-0000-0000-000000000000",
    "firstName": "Jon",
    "lastName": "Snow",
    "randomName": "Frosty Wolf",
    "backOfficeData": [
      {
        "key": "currentPage",
        "value": "https://yourbusiness.com/"
      },
      {
        "key": "currentPageTitle",
        "value": "Your business"
      }
    ],
    "email": "[e-mail]",
    "phone": "[phone]"
  },
  "timestamp": 1560513840901,
  "closedType": "solved",
  "assignee": {
    "id": "00000000-0000-0000-0000-000000000000",
    "firstName": "Bob",
    "lastName": "Holmes",
    "email": "[e-mail]"
    "isBot": false
  },
  "messageHistory": [
    {
      "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "role": "CUSTOMER",
        "email": "[e-mail]",
        "phone": "[phone]"
      },
      "message": "Hello",
      "timestamp": 1560177613051
    },
    {
      "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "role": "ADVISER",
        "email": "[e-mail]",
        "phone": null
      },
      "message": "Hi!",
      "timestamp": 1560177614270
    },
    {
      "author": {
        "id": "00000000-0000-0000-0000-000000000000",
        "role": "CUSTOMER",
        "email": "[e-mail]",
        "phone": "[phone]"
      },
      "message": "Nice to meet you",
      "timestamp": 1560177616949
    }
  ],
  "eventType": "ThreadClosedEvent"
}