Instagram

Send an Instagram message

Sends a direct message, opening the conversation when there is none. Attachments are read from the URLs given.

POST

/api/v1/instagram/messages

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

identityrequired

string

Username without @.

textrequired

string

attachmentsoptional

object[]

Files to send alongside the text.

Response

201Send result.

result

object

messageId

string | null

conversationId

string | null

Pass as conversationId to read the thread back.

sentAt

string · date-time

remainingToday

integer

Remaining daily allowance for this action on the connected account. Each action type has its own limit.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy