# Actions with your own API

> Let the assistant call your systems: check an account, look up an order, reset a setting. Build the request in a form, test it, and choose what it sees.

URL: https://office.greatwork.company/assist/features/custom-api-actions
Last updated: 2026-11-21

Point the assistant at your own systems with an HTTPS request: check an account, look up an order, flip a setting. Built in a form, tested before it goes live.

## A request builder, not a code editor

Give the action a name and a sentence that tells the assistant when to use it. Add the inputs it needs (an order number, a date) with types and descriptions. Then fill in the method, URL with `{param}` placeholders, headers and a JSON body. Secrets like API tokens are stored encrypted and referenced by name, never pasted into the request.

## Choose what it sees

Press **Test action** with sample inputs to see the raw response, then pick the fields the assistant should read, such as `status` or `tracking_url`. Write the message it shows when the call works and when it fails.

## Guard rails included

Mark an action **Ask before running** and the customer sees a confirm button first. Mark it **Requires verified customer** and identity fields are filled in from your site, not from the chat. Only HTTPS is allowed, private network addresses are blocked, and the assistant runs at most one action that changes something per reply.

## Example: Why isn't my calendar syncing?

A scheduling app adds a **Check sync status** action that calls `GET /v1/accounts/{account_id}/sync`. A customer asks why new events aren't showing. The assistant runs the action, reads `"conflict_checking": false`, and replies: "Conflict checking is turned off on your account, so new events aren't being compared. Want me to turn it on?" A second action, marked Ask before running, flips the setting when they press **Turn it on**.

## How to set it up

1. Open Actions and choose Custom HTTP.
2. Describe when to use it and add the inputs it needs.
3. Build the request and add any secrets by name.
4. Press Test action, pick the response fields, then turn it on.

---

Office by Great Work. Questions or corrections: hello@greatwork.company
