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

remainingUsage

object

Remaining allowance for this action on the connected account across hourly, daily, and weekly windows. Each action type has its own limits.

hour

integer | null

Remaining hourly allowance for this action. Null when this action has no hourly cap.

day

integer

Remaining daily allowance for this action.

week

integer | null

Remaining weekly allowance for this action. Null when this action has no weekly cap.

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