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

# InstaWP

> InstaWP spins up WordPress sites on demand. Connect it to WPOS and the agent can create, clone, and manage InstaWP sites, staging, snapshots, and domains from chat.

InstaWP spins up WordPress sites on demand. Connected to WPOS, the agent can create and manage InstaWP sites from chat: clone a site, make a staging copy, take snapshots, install plugins and themes, and map domains.

Connect InstaWP to WPOS

**Category:** Hosting   **Account level:** one connection serves every site in your workspace

## What you can do

* List, create, clone, and delete InstaWP sites
* Create a staging copy, push it live, or reset it
* Create snapshots and use them to seed new sites
* Install plugins and themes, and run saved commands
* Purge the CDN cache
* Map domains and manage DNS records
* Toggle SSH and SFTP access

## Example requests

Once InstaWP is connected, ask in the [Command Center](https://docs.wpos.ai/operate/command-center.md):

```text theme={null}
List my InstaWP sites.
Clone this site so I can try a new layout.
Create a snapshot of this site.
Map shop.example.com to this site.
```

## Before you connect

* An InstaWP account.
* An InstaWP **API token**. Create a **read-write** token if you want the agent to make changes, because a read-only token can only look.

## Connect it

**1. Open Connectors**

Open **Connectors** in the WPOS dashboard, or in WordPress admin open **WPOS**, click **+**, then choose **Connectors**.

**2. Show the hosting providers**

Use the **All / Apps / Hosting** toggle to switch to **Hosting**, or type `InstaWP` into **Search for integrations**.

**3. Press Connect**

Press **Connect** on the InstaWP row. A dialog headed **Connect InstaWP** opens with one field. Leave it open and create the token next.

**4. Create an API token in InstaWP**

In InstaWP, open your profile, then **Account**, then **API Token**, and create a token. Choose **read-write** so WPOS can create and change sites. Copy it.

Click **Where do I find these?** in the WPOS dialog for InstaWP's API documentation.

**5. Paste the token**

Paste it into **InstaWP API token**. It masks as you paste.

**6. Save and connect**

Click **Connect**. WPOS checks the token with InstaWP before saving it. A bad token is refused with InstaWP's reason and nothing is saved.

When it succeeds, the row reads **Connected**.

## What InstaWP does not offer

InstaWP's API has no backup list or restore, logs, SSL, or cron endpoints, so the agent cannot do those. Snapshots only seed new sites, they do not restore an existing one. DNS works only on domains registered with or connected to InstaWP.

## Approvals for risky actions

Destructive actions, such as deleting a site or pushing staging live, are held until you approve them in chat. If no chat is open to ask, they are refused. Reading and listing never need approval.

## Disconnect

Open the InstaWP row and choose **Disconnect**. Your sites stay on InstaWP, and only the stored token is removed from WPOS. To end all access, also delete the token in InstaWP under **Account**, then **API Token**.

## Troubleshooting

> [accordion] Listing works, but creating or changing a site fails
>
> The token is probably read-only. Create a **read-write** token in InstaWP and press **Connect** on the row again to replace it.

> [accordion] “Could not connect InstaWP”
>
> The token was refused. Re-copy it from **Account**, then **API Token**, checking for extra spaces.

> [accordion] A clone or staging request says it started but the site is not there yet
>
> Creating, cloning, and staging run as background tasks on InstaWP. The agent checks the task instead of assuming it finished, so ask for the result in a moment.

For issues shared across every connector, see [Introducing Connectors](https://docs.wpos.ai/connect/connectors.md).


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