# Send an Instagram message

### Send an Instagram message

`POST /api/v1/instagram/messages`

Operation ID: `sendInstagramMessage`

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

**Request body** (required)

- `connectedAccountId` (string · uuid, required): Connected account to act as
- `identity` (string, required): Username without @.
- `text` (string, required)
- `attachments` (object[], optional): Files to send alongside the text.

**201**: Send result.

- `result` (object, required)
  - `messageId` (string | null, required)
  - `conversationId` (string | null, required): Pass as conversationId to read the thread back.
  - `sentAt` (string · date-time, required)
- `remainingUsage` (object, required): 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, required): Remaining hourly allowance for this action. Null when this action has no hourly cap.
  - `day` (integer, required): Remaining daily allowance for this action.
  - `week` (integer | null, required): Remaining weekly allowance for this action. Null when this action has no weekly cap.
- `requestId` (string · uuid, required): 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