Textline API

New Customer Post Webhook

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://reference.textline.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Textline API MCP server": {
    "url": "https://reference.textline.com/mcp"
  }
}
Close
POST https://webhook.example.com

Fires when a new inbound customer message (post) is created.

Delivered with headers X-TGP-EVENT-TYPE, X-TGP-EVENT-TIME, and X-TGP-EVENT-SIGNATURE.

application/json

Body Required

  • webhook string
  • webhook_uuid string
  • post object
    Hide post attributes Show post attributes object
    • attachments array
    • body string | null

      The body of the message, if there is one

    • conversation_uuid string

      The uuid of the parent conversation

    • created_at number

      The unix time stamp of the created time for the post

    • creator object

      If the creator is a customer or user, additional fields specific to those types will be included

      Hide creator attributes Show creator attributes object
      • name `Chuck Finley` string
      • type string

        Values are customer, system, or user.

    • is_whisper boolean
    • marked_as_resolved boolean

      Did this post mark the conversation as resolved

    • transferred_to object

      The agent that this post transferred the conversation to.

      Hide transferred_to attributes Show transferred_to attributes object
      • avatar_url string | null
      • name string
      • on_call boolean

        Is this agent available to receive notifications

      • username string
      • uuid string
      • email string
      • permission_level string
      • group_uuids array
    • assigned_to object

      The agent that claimed the conversation with this post.

      Hide assigned_to attributes Show assigned_to attributes object
      • avatar_url string | null
      • name string
      • on_call boolean

        Is this agent available to receive notifications

      • username string
      • uuid string
      • email string
      • permission_level string
      • group_uuids array
    • uuid string
    • first_post boolean

      Is this the first post in the conversation/thread

    • message_type string

      Outlines whether the message is one of: SMS, webchat, null.

  • conversation object
    Hide conversation attributes Show conversation attributes object
    • customer object
      Hide customer attributes Show customer attributes object
      • avatar_url string | null
      • blocked boolean

        Has this customer has been blocked from sending you messages

      • archived boolean

        Has this customer been archived in your address book

      • name string | null
      • notes string | null
      • phone_number string | null
      • reachable_by_sms boolean

        Is this customer capable of receiving sms

      • tags array
      • uuid string
      • facebook_id string | null
      • custom_fields object

        This is a list of the custom fields created in the account by their uuid and the values for this contact.

        Hide custom_fields attributes Show custom_fields attributes object
        • c43a1766-47e1-4c9c-a2cc-36bf424fcbc0 string
        • 116bad5a-6233-472d-bcf0-199d53342a82 string
      • consent_status boolean

        Has this customer given consent to be messaged. A feature of HIPAA and pro plan accounts. Values of true, false, and null, with null representing no request has been made.

      • verified boolean

        This pertains to webchat and whether a contact has gone through the sync process for the conversation.

    • resolved boolean
    • uuid string
  • group object
    Hide group attributes Show group attributes object
    • name string
    • phone_number string | null
    • uuid string
    • is_sms_group boolean

Responses

  • 200

    Return 200 to acknowledge receipt.

POST new_customer_post
Request example 
{
  "webhook": "new_customer_post",
  "post": {
    "body": "hello world",
    "uuid": "deb79a6a-0652-4e14-86f2-dc8c5c502369"
  },
  "conversation": {
    "uuid": "84a2c56f-6b79-4764-811d-90880e2757b4",
    "resolved": false
  },
  "group": {
    "name": "Sales",
    "uuid": "deb79a6a-0652-4e14-86f2-dc8c5c502369"
  }
}