> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Automate routine admin work with agents that run on a schedule, when something happens, or when another app sends a request, in all or selected locations, and connect an agent to your CRM, SMS, or other apps through an MCP server

Agents automate routine operations in your coworking space. Each agent starts on a schedule, when something happens in your network, or when another app sends it a request, and does its job on its own in Spacebring and in the apps you [connect to it](#connect-other-apps). One emails the customer whose booking was just canceled, another publishes the week's events every Monday morning, a third chases an invoice nobody has paid.

## Create an agent

1. As an owner or a super administrator, go to **Network settings > Agents**.
2. Click **Create agent**.

![Agents settings with the agents table and the Create agent button on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/NeWfkUehO2lBWGut/images/ai-agents-agents-ai-and-agents-settings.png?fit=max\&auto=format\&n=NeWfkUehO2lBWGut\&q=85\&s=5f10bb4859e9b8ae47b29299a95e6aa9)

> [!TIP]
>
> Instead of filling in the form, you can ask Spacebring Agent to create an agent for you. Click **Agent** in the left-side panel and describe the agent you need, for example "Create an agent that thanks members when their booking ends".

3. Enter a **Name** and add a photo. Members see them on anything the agent publishes, such as a feed post, so choose something your team and members will recognize, such as "Front Desk" or "Billing Assistant".
4. Under **Triggers**, choose when the agent runs:
   * **When something happens**, then select what starts the agent in **Events**. Start typing to search the list. Select one event for one job, such as **Contract signed** to email the customer what happens next, or several events when the agent does the same thing for each, such as **Booking created** and **Booking updated**.
   * **On a schedule**, for work that repeats at a set time, such as a daily check of unpaid invoices. Set **Repeat** to **Daily**, **Weekly** with the weekdays to run on, or **Monthly** with the day of the month, from 1 to 28, then the **Time** and **Timezone** to run at.
   * **From another app**, for something that happens outside Spacebring, such as a form submitted in your form tool or a deal won in your CRM. After you create the agent, [paste its webhook URL](#run-an-agent-from-another-app) into that app.
5. Choose where the agent works:
   * Keep **All locations** on for an agent that serves your whole network.
   * Turn **All locations** off and select one or more **Locations** for an agent that serves only some of them — for example, a "Front Desk" agent for one location.

![New agent form with the three trigger options, a daily schedule, and the locations switch on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/8dC1o5664MKZty6f/images/ai-agents-agents-new-agent-form.png?fit=max\&auto=format\&n=8dC1o5664MKZty6f\&q=85\&s=bc43442ab29ab5836de33e4d0815d210)

6. In **Instructions**, describe [what the agent should do](#instructions).
7. Under **Permissions**, choose **Can manage** for every area the agent changes, and **No access** for the areas it shouldn't see.

![New agent form with the instructions filled in and a permission level for each area on Spacebring's coworking space management
platform](https://mintcdn.com/spacebring/sow6uq41aDWzB6wS/images/ai-agents-agents-instructions-and-permissions.png?fit=max\&auto=format\&n=sow6uq41aDWzB6wS\&q=85\&s=10a1f447a675d3101cd49cc4a3f954a6)

8. Click **Create**. The agent is enabled and starts working on its next trigger. To create it without running it yet, turn off **Enabled** first.

> [!TIP]
>
> To start from a ready example, pick a category under **Suggested agents**, such as **Members**, **Support**, or **Billing & reporting**,
> and click one of its cards. These are the agents from the [agents library](https://www.spacebring.com/agents). The form opens filled in,
> and you can change anything before you create the agent.
>
> Some suggested agents work in another app, such as **Maintenance to task board** under **Support**, which turns repair, cleaning,
> and equipment tickets into ClickUp tasks. After you click **Create**, click **Connect** in the pop-up and sign in to the app, or
> [connect it later](#connect-an-app) from the agent's page.

> [!TIP]
>
> Find ideas and examples of agents in the guides on [onboarding and follow-ups](https://www.spacebring.com/docs/guides/automate-onboarding-and-follow-ups.md), [everyday operations](https://www.spacebring.com/docs/guides/automate-everyday-operations-and-scheduled-tasks.md), and [reports and digests](https://www.spacebring.com/docs/guides/send-automatic-reports-and-digests.md).

### Triggers and agent examples

An agent set to **When something happens** runs each time one of its events occurs in the locations it works in, and gets the details of what happened — the booking, the invoice, the ticket. An agent set to **On a schedule** runs at its set time, such as every Monday at 09:00 to publish a feed post with the week's events in each location, or on the 1st of each month to email an administrator a [report](https://www.spacebring.com/docs/guides/send-automatic-reports-and-digests.md) on last month's revenue and new members.

| Area | Events | Example agent |
| - | - | - |
| Bookings | Booking created, Booking updated, Booking paid, Booking ended, Booking canceled | On **Booking canceled**, emails the customer three free slots for the same room that week |
| Check-ins and visits | Checked in, Checked out, Visit created, Visitor checked in, Visit request created, Visit request approved, Visit request rejected | On **Checked in**, emails a day-pass guest the Wi-Fi password and printing rules from your guides; on **Visit created**, emails your front-desk administrator the visitor's name, host, and arrival time |
| Customers | Customer created, Request to join created, Request to join approved | On **Request to join created**, emails an administrator the person's name, company, and the membership they asked about |
| Contracts | Contract issued, Contract signed, Contract declined, Contract terminated | On **Contract signed**, emails the customer the access details and house rules from your location guides |
| Subscriptions | Subscription purchased, Subscription started, Subscription renewed, Subscription ending soon (three days before a subscription's end date), Subscription expired | On **Subscription ending soon**, emails the member the memberships they can continue on |
| Invoices | Invoice created, Invoice issued, Invoice paid, Invoice voided | On **Invoice issued**, asks customers with no saved payment method to add one so their next invoice is paid automatically |
| Events | Event ticket created, Event ticket paid | On **Event ticket paid**, emails the attendee the address, start time, and how to check in |
| Orders | Order created, Order paid, Order completed, Order canceled | On **Order completed**, emails the customer a thank-you and asks how the purchase worked out |
| Support | Support ticket created, Support ticket status updated, Support ticket comment created | On **Support ticket status updated**, emails the customer a summary once their ticket is solved |
| Chats | Chat message received (someone messages the agent in chats) | On **Chat message received**, answers a member's question about opening hours or a free meeting room in the same chat |

### Run an agent from another app

An agent set to **From another app** runs each time another app sends a request to the agent's webhook URL, and gets the content of the request as the details of what happened, such as the answers to a form. Use it for an app that can call a URL when something happens in it, such as a form tool, a CRM, or an automation tool like Zapier or Make.

1. Create the agent with **From another app** under **Triggers**, and keep **Enabled** on.

![New agent form with the From another app trigger selected on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/8dC1o5664MKZty6f/images/ai-agents-agents-run-an-agent-from-another-app-1.png?fit=max\&auto=format\&n=8dC1o5664MKZty6f\&q=85\&s=df4aa3cb29cd1c91a31f2735c2d60648)

2. Open the agent on the **Network settings > Agents** page, and click the copy icon next to the webhook URL under **Triggers**.

![An agent page with the Request from another app trigger and its webhook URL with a copy icon in the sidebar on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/8dC1o5664MKZty6f/images/ai-agents-agents-run-an-agent-from-another-app-2.png?fit=max\&auto=format\&n=8dC1o5664MKZty6f\&q=85\&s=b34598aba936dde6d404984b29af0896)

3. In the other app, paste the URL where it sends a webhook when something happens, such as a "Send to webhook" step after a form is submitted.

* An agent that is turned off doesn't accept requests, so turn it on before you test the other app.
* A request that the other app sends again doesn't start a second run: one with the same delivery ID within a day, or with the same content within an hour.
* An agent runs at most 60 times an hour from requests, and a request can be at most 32 KB.
* Click a run to see the **Request body** the other app sent.

> [!WARNING]
>
> Anyone who has the webhook URL can start the agent, and a request often carries text from the public, such as a form answer. So when
> you choose **From another app**, every **Can manage** permission drops to **Can view**, and the **Settings** permission to **No access**. Set the **Can
> manage** permission again under **Permissions** on the agent's page only where the agent's job needs to make changes. If the URL gets out, open the agent, click the **(...)** menu, and choose
> **Regenerate webhook URL**. The old URL stops working at once, so paste the new one into the other app.

### Instructions

The instructions are the agent's whole brief: it sees which trigger started the run, the details that came with it, and the data in the areas you allowed. Write them the way you would brief a new team member:

* Say what to look up first, such as the customer, the resource, or your location guides.
* Say what to produce and who gets it: an email to the customer or to an administrator, a feed post, an updated item.
* Say when the agent should do nothing, for example: "If the booking was canceled by an administrator, do nothing."
* Say which language to write in, for example: "Write in the customer's language."
* Give one job to one agent. For a second job, create a second agent.

> [!TIP]
>
> For a report, ask the agent to attach each table as a CSV file and keep the email to a short summary. This lets you open the tables in a spreadsheet for easy analysis, or save them for later.

To put a link in the agent's emails, such as one to your parking rules, select the words in **Instructions** on the web and click **Link**. The agent keeps the link on the same words in the email.

An agent can:

* Look up anything in your network, from customers and bookings to invoices, orders, events, visits, tickets, guides, sent emails, and settings.
* Email one customer of its locations or one administrator at a time, in your network's branding.
* Prepare reports and email them to you or your team, with up to 5 CSV files attached to each email, one for each table.
* Publish and edit feed posts.
* Message people in chats and create group chats.
* Open support tickets, comment on and reply to them, and change their status, assignee, or type.
* Invite members, add nonmembers, create companies, edit customers' billing details, notes, and payment settings, move members to a company or remove them from it, change their company role, remove members and companies, and delete nonmembers.
* Create, copy, and edit resources, products, events, benefits, guides, memberships, packages, discounts, currencies, and categories, and delete resources, memberships, and coupons.
* Book resources for customers, and change or cancel bookings. An agent doesn't run again for a booking it created, changed, or canceled itself.
* Assign resources to customers for a period without a subscription, and change or remove those assignments.
* Change or cancel subscriptions and their items, and issue, re-date, terminate, or delete contracts.
* Create, issue, void, and delete invoices, change their items, and issue or void credit notes.
* Add or deduct a customer's credits and day passes.
* Change location settings.
* Use the apps you [connect to it](#connect-other-apps).
* Search the web and the Spacebring documentation. An agent started by an event can't open links or download files from them, so text that a member or visitor writes can't make it send your data elsewhere.

### Permissions

Each area has a level, the same as an [administrator permission](https://www.spacebring.com/docs/administration/permissions.md) of that name: **No access** keeps the agent out of the area, **Can view** lets it look up data without changing anything, and **Can manage** lets it make changes. A new agent can view most areas, so set the **Can manage** permission where its job needs to make changes:

* **Customers** — customer profiles and their data.
* **Billing** — contracts, subscriptions, invoices, memberships, and discounts.
* **Resources** — resources and bookings.
* **Feed** — posts and comments.
* **Events** — events and tickets.
* **Shop** — products, categories, and orders.
* **Benefits** — benefits, categories, and applications.
* **Support** — support tickets and guides.
* **Analytics** — occupancy and the other numbers on the **Analytics** page. It has only **No access** and **Can view**.
* **Settings** — location settings and integrations. It has only **No access** and **Can manage**.

The permissions apply only to the agent's locations.

> [!WARNING]
>
> An agent never asks for approval. A run has nobody to ask, so the agent carries out actions such as sending an email to a customer, in
> Spacebring and in the apps you connect to it. It works like a chat set to [Auto-approve](https://www.spacebring.com/docs/ai-agents/create-edit-configure.md#auto-approve-actions). Turn on only the areas the agent's task needs.

## Review runs

Every start of an agent is recorded as a run, and the AI usage of each run is charged to your [network balance](https://www.spacebring.com/docs/ai-agents/network-balance.md). Open an agent on the **Network settings > Agents** page to see its **Runs**, newest first.

![An agent page with its instructions and runs, and its status, trigger, locations, permissions, and apps in the sidebar on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/8dC1o5664MKZty6f/images/ai-agents-agents-agent-runs.png?fit=max\&auto=format\&n=8dC1o5664MKZty6f\&q=85\&s=2027ec979d70d07d23670ada178bdaa9)

* A run shows what the agent said when it finished, the trigger that started it, how many steps it took, and when it ran.
* **Running** means the agent is still working, **Completed** that it finished, and **Failed** that it stopped with an error, which the run shows. A failed run isn't started again, so the agent never repeats an email or a change it already made.
* **Incomplete** means the agent finished but couldn't do part of its task — for example, the app it needs isn't connected to it, or it doesn't have permission for a location. The run says what was missing.

> [!TIP]
>
> When a run fails or is incomplete, owners and super administrators get a [notification](https://www.spacebring.com/docs/account/notifications.md) that links to the agent's runs, once a day for each agent.

* **Skipped** means the agent didn't run because your network's balance ran out. Network owners are notified, and runs resume once the balance is [topped up](https://www.spacebring.com/docs/ai-agents/network-balance.md#top-up-the-balance).
* Click a run to open its page. The conversation in the middle shows the instructions the agent followed, every change it made, the CSV files it wrote, and its full reply, and the sidebar on the right shows the run's status, trigger, start time, duration, and number of steps. Each change shows what the agent did and to whom — for example, the subject of an email and the address it went to — and a failed run still lists the changes made before it stopped. Click a change to open what the agent created or changed, such as a booking, a contract, or a support ticket.

![An agent run page with the instructions, the email the agent sent, and its reply, and the run's status, trigger, start time, duration, and steps in the sidebar on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/8dC1o5664MKZty6f/images/ai-agents-agents-review-runs-2.png?fit=max\&auto=format\&n=8dC1o5664MKZty6f\&q=85\&s=880355e98465553948042d7cac95f774)

> [!TIP]
>
> Agents can make mistakes. Test a new agent before you rely on it: cause its trigger yourself a few times, or set its schedule to the next
> quarter of an hour, then read those runs and correct the instructions where the agent went the wrong way.

## Manage agents

On the **Network settings > Agents** page, click the **(...)** menu next to an agent:

* **Disable** stops the agent from running and keeps it in the list with its past runs. **Enable** starts it again.
* **Edit** changes the name, photo, triggers, schedule, and instructions. The agent's next run follows the new setup.
* **Delete** removes the agent for good: it stops running and disappears from the list, and this cannot be undone.

To turn an agent on or off, change its locations, or change its permissions, open the agent and use the sidebar on the right. Each change is saved at once, and the agent's next run follows it:

* **Enabled** turns the agent on or off.
* **All locations**, or the locations under it, choose where the agent works.
* Each area under **Permissions** has its level. Click **Add permission** to give the agent an area it has no access to, and choose **No access** to take one away.

## How agents appear in your network

An agent is a separate user in your network, under the name and photo you gave it.

* A feed post it publishes carries that name and photo, like a post from any other author.
* A chat message it sends comes from that name and photo too.
* The emails it sends go out under your network's name, like every other Spacebring email.

![A feed post published by an agent under its name and photo on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/WDLYHBSw6l3WH8KC/images/ai-agents-agents-feed-post-by-an-agent.png?fit=max\&auto=format\&n=WDLYHBSw6l3WH8KC\&q=85\&s=3627be2158a816ade8d7829b13c21d05)

## Connect other apps

Connect another app, such as your CRM, so an agent can work in it: look up a deal, read a page, or create a task. Popular apps, such as Notion or Stripe, connect in one click. Any other app connects through its MCP server, and the app's help center gives the server's URL and how to sign in.

### Connect an app

1. Open the agent on the **Network settings > Agents** page.
2. In the **Apps** section on the right, click **Connect app** and choose the app, such as Notion.

![Agent page with the Connect app menu open, listing apps such as HubSpot, Notion, and Stripe and the Custom MCP server option, on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/gTdAMuw-ohONK-zT/images/ai-agents-agents-connect-an-app-1.png?fit=max\&auto=format\&n=gTdAMuw-ohONK-zT\&q=85\&s=3fc93528646b6533c6a78a14e04c5ef9)

3. Sign in to the app and allow access, and you come back to Spacebring.

To connect an app that isn't in the list:

1. In the agent's **Apps** section, click **Connect app**, then **Custom MCP server**.
2. Enter a **Name**, such as "HubSpot".
3. Enter the **URL** of the app's MCP server, such as `https://mcp.hubspot.com`.
4. Optionally, in **Description**, say what the app is for and when the agent should use it, such as "Our CRM. Use it for leads and deals."
5. In **Authentication**, choose how Spacebring gets access to the app:
   * **OAuth sign-in** — you sign in to the app on its website. Fill in **Client ID** and **Client secret** only if the app asks you to register Spacebring yourself.
   * **API key** — enter a key you created in the app.
   * **API key in a custom header** — enter the **Header name** from the app's help center, such as `X-API-Key`, and the **API key**.
   * **No authentication** — for an app that needs no sign-in.

![Connect custom MCP server form with the HubSpot name, URL, and description filled in and OAuth sign-in selected on Spacebring's
coworking space management platform](https://mintcdn.com/spacebring/DHqFoBq56NGGDPiO/images/ai-agents-agents-connect-an-app-2.png?fit=max\&auto=format\&n=DHqFoBq56NGGDPiO\&q=85\&s=04c0cf5da9843bf0d1c5f41f188e513a)

6. Click **Connect**. For **OAuth sign-in**, sign in to the app and allow access, and you come back to Spacebring.

The agent uses the app from its next run, as the account you signed in with or with your API key. An app is connected to one agent only, so connect it to each agent that needs it.

> [!TIP]
>
> A suggested agent that works in another app asks you to connect it right after you click **Create**. For example, **Events from Luma**
> under **Suggested agents > Community & growth** posts the week's events from your Luma calendar to your Feed every Monday. Click **Connect**
> and sign in to Luma, or click **Not now** and connect Luma later in the agent's **Apps** section.

> [!TIP]
>
> You can also connect an app from a chat. Open the agent's page, click **Ask Spacebring** in the top right corner, and ask, for example, "Connect Notion to this agent".

### Manage connected apps

In the agent's **Apps** section, point to an app and click its **(...)** menu:

* **Disable** stops the agent from using the app. **Enable** turns it back on.
* **Edit** changes an MCP server's name, URL, description, and API key. For an app connected with **OAuth sign-in**, you can change only the name and description.
* **Disconnect** for an app you chose from the list, or **Delete** for an MCP server, removes the app with its sign-in or API key, and this cannot be undone.

The agent can't use an app marked **Waiting for sign-in** or **Sign-in expired**. To sign in again, click **Sign in** next to the app, or delete an MCP server and connect it again.

## FAQs

> [accordion] Can I text customers, such as a link to their invoice?
>
> Yes, from your Quo number. Connect Quo to [Spacebring Agent](https://www.spacebring.com/docs/ai-agents/ask.md#connect-other-apps) to send a text when you ask in a chat, or to [your custom agent](#connect-an-app) to send texts on a schedule or when something happens, such as a link to the invoice on **Invoice issued**. Texts go to the phone number in the customer's profile, and each one counts against your Quo messaging credits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.