Skip to main content
Each scope is a door on your key: connection, send, read, edit, or comment moderation, open only what you need.
Each scope unlocks one kind of Instagram operation. Grant only what your integration needs.

​
How to send the key

Recommended
Alternative
The API key belongs to one workspace. You cannot access another workspace with the same key.

​
Common combinations

Basic send

instagram:instances:create, instagram:instances:list, instagram:send

Send and read

instagram:send, instagram:read

With cancel

instagram:send, instagram:cancel

Full flow

instagram:send, instagram:read, instagram:cancel, instagram:update, instagram:delete
An empty scope list on creation means ADMIN access. Always restrict in production.

​
Available scopes

List Instagram connections for the workspace.
Create a connection and complete login (includes resolving challenges).
Disconnect an active session.
Remove a connection.
Send DMs: text and media via HTTPS URL.
List outbound, inbound, connection status, and comments.
Cancel a queued or scheduled message.
Edit text of a sent message (15-minute window, up to 5 edits, max 1000 characters).
Unsend a sent message when Instagram allows it.
Reply to comments on your own media.
Moderate comments (for example delete).

​
Limit by connection

If the key has an instance allowlist, it only sees those connections.

​
Next steps