# Dev Blocks: API Calls, Integrations and Notes

Call your APIs, use connected apps like Google Sheets, HubSpot and Slack, and leave notes in a workflow.

> Source: https://www.robylon.ai/docs/product/dev-notes
> Section: Automation

Dev blocks connect a workflow to other systems: your own APIs, and the connected apps listed below. Notes let you document the workflow on the canvas.

Find them under **Dev** and **Notes** in the workflow builder's toolbar.

| Block | Use it to |
| --- | --- |
| API | Send an HTTP request and save the response. |
| Function | Run a function the Robylon team has set up for your workspace. |
| Integration | Use an action in a connected app. |
| MCP | Run a ready-made action in a connected app: Zendesk, Freshdesk, Slack, HubSpot, Google Sheets, Twilio Text or Microsoft Teams. |
| Add Note | Leave a note on the canvas. |

## How the API block works

**API** sends a request and saves what comes back. Pick one of your [saved APIs](https://www.robylon.ai/docs/data-and-integrations/apis#create-an-api) or set up a request in the block: method, URL, headers, parameters and body, with variables where values change. Then capture the fields you need from the response into variables.

The block has a **Success** exit and a **Failure** exit. Always connect **Failure**, for example to an internal note and a handover, so the customer is not left waiting when your system is down.

Requests time out after 120 seconds by default. You can turn on automatic retries, choose which status codes to retry, and set the retry strategy. See [how retries work](https://www.robylon.ai/docs/data-and-integrations/apis#how-retries-work).

Example: look up a customer's orders by email.

```http
GET https://yourstore.com/api/orders?email={user_email}
Authorization: Bearer {store_api_token}
```

## How the Integration block works

**Integration** runs an action in a connected app, without building an API request.

| App | Actions |
| --- | --- |
| Google Sheets | Create a Spreadsheet Row, Search a Spreadsheet Row, Update a Spreadsheet Row, Extract Spreadsheet Data |
| HubSpot | Create, search or update a contact, company or deal |
| Salesforce | Create, search or update a contact, account or opportunity |
| WhatsApp | Send a Template, with an optional **Backup Template** |
| Instagram | Send reply to comment, Send reply in DM, Hide comment |
| YouTube | Send reply to comment, Hide comment. See [YouTube actions](https://www.robylon.ai/docs/channels/youtube#youtube-actions-in-a-workflow). |

Choose the app under **Select App**, then configure the action and its fields. For Google Sheets, HubSpot and Salesforce, click **Connect** in the block to connect an account. For Google Sheets, also choose the **Drive**, **Spreadsheet** and **Worksheet**. For WhatsApp, pick one of the numbers connected under [**Settings → Channels**](https://app.robylon.ai/settings/channels).

## How the Function block works

**Function** runs one of the functions the Robylon team has set up for your workspace. Pick the function, map its inputs to variables, and its outputs are saved into variables for later blocks. To have a function written for your workspace, email support@robylon.ai.

**Include Output downstream** is on by default. Turn it off to leave the function's result out of the conversation history that later blocks and AI agents read.

The block has a **Success** exit and a **Failure** exit.

## How the MCP block works

**MCP** runs a ready-made action in one of your connected apps: Zendesk, Freshdesk, Slack, HubSpot, Google Sheets, Twilio Text or Microsoft Teams. For example, send a message to a Slack channel when a VIP customer writes in.

The MCP block is different from the [Robylon MCP server](https://www.robylon.ai/docs/mcp/overview), which works in the other direction: it lets outside AI assistants, for example Claude or ChatGPT, read your Robylon analytics and conversations.

<Steps>
  <Step title="Select Connector">
    Choose the app.
  </Step>
  <Step title="Choose the account">
    Pick a connected account, or connect one from the block.
  </Step>
  <Step title="Select Action Template">
    Choose one of the pre-configured actions for that app.
  </Step>
  <Step title="Fill the inputs">
    Under **Tool Inputs**, set each input to a **Fixed Value** or **Get from Variables**.
  </Step>
  <Step title="Capture the response (optional)">
    Under **Capture Response**, save fields from the result into variables.
  </Step>
</Steps>

The block has **Success** and **Failure** exits.

## How notes work

**Add Note** places a note on the canvas. Use notes to explain why a step exists or what a condition checks, so teammates can follow the workflow later. Notes do not run and are not connected to other blocks.

<Tip>
Also give every block a clear title. Block titles show up in [Runs](https://www.robylon.ai/docs/product/runs), so good names make it quicker to find where a run went wrong.
</Tip>
