Send message with group context

Send a LinkedIn message to someone using group membership context. Allows messaging non-connections who are members of the same LinkedIn group without using InMail credits. Rate limit: 150 messages per day per account.

POST/messaging/send-group

Authentication requiredMessaging

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/messaging/send-group' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"recipientProfileUrn":"urn:li:fsd_profile:ACoAAFpqSoMB8vTqRbg4mN_wbabO8w0gjgFu-6o","groupId":"12345678","message":"Hello fellow group member!"}'

Parameters

No parameters.

Request Body

Field	Type	Required	Description
`accountId`	string	No	LinkedIn account ID to use. If not provided, uses the default account.
`recipientProfileUrn`	string	Yes	Recipient LinkedIn profile URN (e.g., "urn:li:fsd_profile:ACoAABJefVoBrz2LR3f..."). Preferred over recipientProfileId.
`groupId`	string	Yes	LinkedIn group ID that both sender and recipient are members of
`message`	string	Yes	Message content to send

Example

{
  "recipientProfileUrn": "urn:li:fsd_profile:ACoAAFpqSoMB8vTqRbg4mN_wbabO8w0gjgFu-6o",
  "groupId": "12345678",
  "message": "Hello fellow group member!"
}

Responses

Status	Description
200	Group context message sent successfully
400	Bad request - Missing required parameter
401	Unauthorized - Invalid or missing API key
403	Forbidden - Not authorized to message this user via group
429	Rate limit exceeded
500	Server error

Rate Limit Headers

All responses include rate limit information in the headers:

Header	Description
`X-RateLimit-Action`	The action type being rate limited
`X-RateLimit-Limit`	Maximum actions allowed per period
`X-RateLimit-Used`	Actions used in current period
`X-RateLimit-Remaining`	Actions remaining
`X-RateLimit-Reset`	ISO 8601 timestamp when limit resets

200 Response Parameters

Name	Type	Description
`success`	boolean
`message`	string
`recipientProfileUrn`	string
`groupId`	string

200 Example

{
  "success": true,
  "message": "Group context message sent successfully",
  "recipientProfileUrn": "urn:li:fsd_profile:ACoAAFpqSoMB8vTqRbg4mN_wbabO8w0gjgFu-6o",
  "groupId": "12345678"
}

400 Response Parameters

Name	Type	Description
`success`	boolean
`error`	object

400 Example

{
  "success": false,
  "error": "recipientProfileUrn, groupId, and message are required"
}

401 Example

{
  "error": "Unauthorized - Invalid credentials"
}

403 Example

{
  "success": false,
  "message": "Error sending group context message: Request failed with status code 403",
  "recipientProfileUrn": "urn:li:fsd_profile:ACoAAFpqSoMB8vTqRbg4mN_wbabO8w0gjgFu-6o",
  "groupId": "12345678",
  "errorDetails": {
    "status": 403,
    "statusText": "Forbidden",
    "data": {
      "code": "UNAUTHORIZED_VIEWER",
      "message": "The viewer is not authorized to access this resource"
    }
  }
}

429 Response Parameters

Name	Type	Description
`error`	string
`success`	boolean

429 Example

{
  "error": "Rate limit exceeded for MESSAGE: 150/150 used",
  "success": false
}

500 Example

{
  "error": "Failed to get LinkedIn authentication credentials",
  "success": false
}

Code Examples

On this page