Messages

Discover how to leverage Messages sent and received within Thumbtack.

Overview

Messaging allows customers and Pros to chat in order to discuss job details.

The Messages API supports several operations, discussed below.

Get All Messages

You can view all Messages sent as part of a Negotiation via:

GET /api/v4/negotiations/{{negotiationID}}/messages HTTP/2
authorization: Bearer {{authCode}}

{
  "data": [
    {
      "messageID": "519153481515696128",
      "negotiationID": "519153480500518912",
      "customer": {
        "customerID": "519153480034934784",
        "displayName": "Olivia Y."
      },
      "from": "Customer",
      "text": "Are you available on my date?",
      "attachments": [],
      "sentAt": "2024-06-13T17:18:01Z"
    }
  ],
  "pagination": {
    "limit": 3
  }
}

Send a Message to a Negotiation

You can also send Messages to a Negotiation via:

POST /api/v4/negotiations/{{negotiationID}}/messages HTTP/2
authorization: Bearer {{authCode}}
content-type: application/json
{
  "text": "Hello world"
}

On this page

Messages

Overview