Instagram

Manage Instagram Business accounts, publish media, and access insights.

Detail	Value
Category	Social Media
Base URL	https://graph.facebook.com/v19.0
Authentication	OAuth2
Endpoints	5
Connector key	instagram

Using Instagram in a workflow

1. Go to Connections and click New Connection.
2. Pick Instagram from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /{userId}	Get user profile
GET /{userId}/media	List user media
POST /{userId}/media	Create a media container
POST /{userId}/media_publish	Publish media
GET /{userId}/insights	Get account insights

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /{userId}

Get user profile

Detail	Value
Operation ID	social.getProfile
Method	GET
Path	/{userId}

Parameters

Name	Location	Type	Required
userId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Instagram connection from the Connection dropdown.
3. In the Operation dropdown, select social.getProfile.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Instagram API reference.

GET /{userId}/media

List user media

Detail	Value
Operation ID	social.listMedia
Method	GET
Path	/{userId}/media

Parameters

Name	Location	Type	Required
userId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Instagram connection from the Connection dropdown.
3. In the Operation dropdown, select social.listMedia.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Instagram API reference.

POST /{userId}/media

Create a media container

Detail	Value
Operation ID	social.createMedia
Method	POST
Path	/{userId}/media

Parameters

Name	Location	Type	Required
userId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Instagram connection from the Connection dropdown.
3. In the Operation dropdown, select social.createMedia.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Instagram API reference.

POST /{userId}/media_publish

Publish media

Detail	Value
Operation ID	social.publishMedia
Method	POST
Path	/{userId}/media_publish

Parameters

Name	Location	Type	Required
userId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Instagram connection from the Connection dropdown.
3. In the Operation dropdown, select social.publishMedia.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Instagram API reference.

GET /{userId}/insights

Get account insights

Detail	Value
Operation ID	social.getInsights
Method	GET
Path	/{userId}/insights

Parameters

Name	Location	Type	Required
userId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Instagram connection from the Connection dropdown.
3. In the Operation dropdown, select social.getInsights.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Instagram API reference.