Skip to main content
POST
/
v1
/
conversations
/
{conversationUrn}
/
messages
Send Message
curl --request POST \
  --url https://app-api.walead.ai/api/v1/conversations/{conversationUrn}/messages \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "message": "<string>"
}
'
{
  "success": true,
  "message": "<string>"
}

​
Overview

Sends a message in an existing conversation. Use this to reply to leads directly from your application or automation.

​
Requirements

  • The conversation must exist in your workspace
  • Message text is required and cannot be empty
  • The LinkedIn account must be connected and active

​
Message Formatting

  • Plain text messages are supported
  • Leading and trailing whitespace is automatically trimmed
  • Empty messages will return a 400 error

​
Use Cases

  • Build custom chat interfaces
  • Automate responses based on lead behavior
  • Reply to leads from your CRM
  • Implement chatbot functionality

​
Important Notes

  • Messages are sent immediately
  • Sent messages appear in both your WaLead inbox and LinkedIn
  • Rate limits apply based on LinkedIn’s restrictions

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Path Parameters

​
conversationUrn
string
required

Conversation URN identifier

Body

application/json

Message content

​
message
string
required

Message text to send

Response

Message sent successfully

​
success
boolean
​
message
string