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

# WordPress (self-hosted)

> Set up and use the WordPress.org (self-hosted) integration with Hyper AI for blog post automation

The WordPress.org integration lets your agents and workflows manage content on a self-hosted WordPress site via the REST API — posts, media, categories, and tags. For WordPress.com sites, see [WordPress](/integrations/wordpress).

Auth type: Application Password

<Info>
  For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: [App Integrations](/integrations/overview).
</Info>

## Connect WordPress (self-hosted)

1. Go to **Settings → Apps** in Hyper
2. Select **WordPress (self-hosted) → Connect New**
3. Provide your site URL, WordPress username, and an Application Password

### Where to create an Application Password

1. In your WordPress admin, go to **Users → Your Profile**
2. Scroll to **Application Passwords**
3. Name it "Hyper" and click **Add New Application Password**
4. Copy the generated password and paste it into Hyper

<Note>
  Application Passwords are different from your regular WordPress login. They're per-app credentials you can revoke at any time without changing your password.
</Note>

## Common capabilities

* **Posts** — create, update, delete, list, get
* **Media** — upload, list, get, delete (for images and other attachments)
* **Categories** — list, create
* **Tags** — list, create
* **Verify credentials** — confirm the connection is healthy

## Use in Chat

1. In a chat, open the tool selector and enable WordPress (self-hosted)
2. Ask your agent to draft and publish

Example prompt:

```text theme={null}
Write a 1,000-word WordPress post on "AI agents for marketing teams." Use the "guides" category and tag it "ai" and "marketing." Generate a featured image, upload it, set it as the post's featured image, and publish.
```

## Use in Agents

In `Agents → Settings`, add WordPress to a content / SEO agent. Toggle approval on `delete_post` and `delete_media` if you want a safety net.

## Use in Flows

Add WordPress nodes to content workflows: research → draft → upload images → publish on schedule.

## Troubleshooting

* **401 unauthorized**: Application Passwords must be entered exactly as shown (with spaces). Confirm the WordPress user has post-publishing capability
* **REST API not found**: WordPress REST API must be enabled (it's on by default in modern WordPress). Some security plugins disable it — check `https://your-site.com/wp-json/`
* **Image upload failed**: media uploads respect WordPress's `upload_max_filesize` PHP setting on your host

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action              | Description                                                              |
| ------------------- | ------------------------------------------------------------------------ |
| Org Create Category |                                                                          |
| Org Create Post     |                                                                          |
| Org Create Tag      | Create a new tag on a self-hosted WordPress site                         |
| Org Delete Media    |                                                                          |
| Org Delete Post     |                                                                          |
| Org Get Media       | Retrieve a single media item from a self-hosted WordPress site by its ID |
| Org Get Post        | Retrieve a single post from a self-hosted WordPress site by its ID       |
| Org List Categories | List all categories on a self-hosted WordPress site                      |
| Org List Media      | List media items from a self-hosted WordPress media library              |
| Org List Posts      |                                                                          |
| Org List Tags       | List all tags on a self-hosted WordPress site                            |
| Org Update Post     |                                                                          |
| Org Upload Media    |                                                                          |