WordPress (legacy)
Version Legacy
Here is the documentation for the new WordPress app.
Getting Started with Wordpress
The Wordpress modules allow you to monitor, publish, update, delete, or search posts, pages, comments, media, users, and tags on your Wordpress site.
Prerequisites
- Wordpress installed on your server
- A Basic Authentication for JSON plugin installed in your Wordpress
- Modified
.htaccess
orweb.config
file (optional) - Custom Fields for REST API plugin (optional, for working with custom fields)
In order to use Wordpress with Integromat, it is necessary to have the Wordpress content management system installed on your server or webhosting.
You can download Wordpress at wordpress.org/download/ and install by following the instructions on wordpress.org/support/article/how-to-install-wordpress.
Connecting Wordpress to Integromat
To connect your Wordpress account to Integromat, the JSON Basic Auth plugin has to be installed in your Wordpress installation.
1. Visit github.com/WP-API/Basic-Auth and download the JSON Basic Authentication plugin (direct link).
2. Log in to your Wordpress administration and open Plugins.
3. Click the Add New button.
4. Click on the Upload plugin button, browse and select the plugin ZIP file.
5. Click on the Install now button to install the plugin.
6. After the installation is finished, click on the Activate Plugin button.
7. Go to Integromat and open the Create a connection dialog of the desired Wordpress module. Enter the URL of your Wordpress site and your Wordpress credentials to the respective fields.
8. Establish a connection by clicking the Continue button.
.htaccess
file to allow the HTTP authorization header:<IfModule mod_setenvif>
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
</IfModule>
If your Wordpress is on the Windows server (IIS), please contact your administrator in order to allow the HTTP authorization header.
Add the Self-signed Certificate When Using Secured HTTPS Connection
Self-signed certificate | Click the Extract button to open the upload dialog. Upload the certificate to use the TLS with your self-signed certificate. Integromat does not retain or store any data (files, passwords) you provide. File and password are only used to extract the certificate. For more details about certificates and keys please refer to the Certificates and Keys article. |
Custom Fields for REST API plugin installation
1. Visit https://wordpress.org/plugins/rest-api-custom-fields/ and download the Custom Fields for REST API plugin (direct link).
2. Log in to your Wordpress administration and open Plugins.
3. Click the Add New button.
4. Click on the Upload plugin button, browse and select the plugin ZIP file.
5. Click on the Install now button to install the plugin.
6. After the installation is finished, click on the Activate Plugin button.
7. Follow these instructions in order to add a custom field to your post, page, media, or another object.
8. Go to Settings and open the Rest API Custom Fields dialog.
9. Select the desired object's custom fields you want to include in the REST API response.
10. Click on the Save Settings button.
11. The selected custom fields are now available in the module response.
Posts
Watch Posts
Triggers when a new object (post, page, or media) is added.
Connection | Establish a connection to your Wordpress. |
Type | Select whether you want to retrieve newly added posts, pages, or media. |
Limit | Set the maximum number of objects Integromat will return during one cycle. |
Create a Post
Creates an object.
Connection | Establish a connection to your Wordpress. |
Type | Select whether you want to retrieve newly added posts, pages, media, or another object. |
Title | Set the post's title. |
Content | Enter the content of the new post. HTML is allowed. |
Excerpt | Enter the excerpt content for the post. |
Date | Enter the date of the new post. List of supported date formats. |
Slug | Enter the post's slug (in order to have more SEO-friendly URL). |
Status | Set the status of the new post. If no status is selected the post's status will be set to draft. |
Format | Select one of the formats for the post. For more information about post formats refer to wordpress.org/support/article/post-formats. |
Password | Set the password if you want the post password protected. |
Sticky | Set whether or not the object should be treated as sticky. |
Categories | Select categories that a new post should belong to. |
Tags | Select tags for the new post. |
Author | Set the author of the post. |
Featured media ID | Enter the ID of the media. Retrieve the media by following these steps: 1. Open Media settings. 2. Change the mode to List view. 3. Hover the mouse over the image. 4. See the media ID in the status bar. |
Comment status | Set whether or not comments are open on the post. |
Ping status | Set whether the post can be pinged. |
Update a Post
Allows you to modify the existing post.
Connection | Establish a connection to your Wordpress. |
Post ID | Enter (map) the ID of the post you want to update. |
Please find the descriptions of the fields in the section Create a Post above.
Delete a Post
Deletes a specified Wordpress object (post, page, media, product, ...)
Connection | Establish a connection to your Wordpress. |
Post ID | Enter (map) the ID of the object you want to delete. |
Get a Post
Retrieves details of a post.
Connection | Establish a connection to your Wordpress. |
Type | Select the type of post you want to retrieve details about. |
Post ID | Enter (map) the ID of the post you want to retrieve details about. |
Search for a Post
Searches for a post and returns its details.
Connection | Establish a connection to your Wordpress. |
Type | Select the type of post you want to search. |
Search term | Enter the search term. |
Limit | Set the maximum number of results Integromat will return during one cycle. |
Pages
Watch pages
Triggers when a new page is published.
Connection | Establish a connection to your Wordpress. |
Limit | Set the maximum number of pages Integromat will return during one cycle. |
Create a Page
Creates a page.
Connection | Establish a connection to your Wordpress. |
Title | Set the page's title. |
Content | Enter the content of the new post. HTML is allowed. |
Date | Enter the date of the new page. List of supported date formats. |
Slug | Enter the page's slug (in order to have a more SEO-friendly URL). |
Status | Set the status of the new page. If no status is selected the page's status will be set to draft. |
Password | Set the password if you want the page password protected. |
Parent object ID | Enter the ID of the parent object, if needed. |
Author | Set the author of the new page. |
Featured media ID | Enter the ID of the media. Retrieve the media by following these steps: 1. Open Media settings. 2. Change mode to List view. 3. Hover the mouse over the image. 4. See the media ID in the status bar. |
Comment status | Set whether or not comments are open on the page. |
Ping status | Set whether the page can be pinged. |
Update a page
Allows you to modify the existing page.
Connection | Establish a connection to your Wordpress. |
Page ID | Enter (map) the ID of the page you want to update. |
Please find the descriptions of the fields in the section, Create a Page above.
Delete a Page
Deletes a specified page.
Connection | Establish a connection to your Wordpress. |
Page ID | Enter (map) the ID of the page you want to delete. |
Get a Page
Retrieves the details of a page.
Connection | Establish a connection to your Wordpress. |
Page ID | Enter (map) the ID of the page you want to retrieve details about. |
Search for a Page
Searches for a page and returns its details.
Connection | Establish a connection to your Wordpress. |
Search term | Enter the search term. |
Limit | Set the maximum number of pages Integromat will return during one cycle. |
Categories
Watch Categories
Triggers when a new page is created.
Connection | Establish a connection to your Wordpress. |
Limit | Set the maximum number of categories Integromat will return during one cycle. |
Create a Category
Adds a new category.
Connection | Establish a connection to your Wordpress. |
Name | Enter the name of the category and how it appears on your site. |
Description | Enter the text for the description. The description is not prominent by default; however, some themes may show it. |
Slug | Enter the slug of the category you want to create. The slug is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens. |
Parent category ID | Enter the ID of the parent category in the case where you want to create a child category. |
Update a Category
Modifies an existing category.
Connection | Establish a connection to your Wordpress. |
Category ID | Enter (map) the ID of the category you want to update. |
Please find the descriptions of the fields in the section Create a Category above.
Delete a Category
Deletes a specified category.
Connection | Establish a connection to your Wordpress. |
Category ID | Enter (map) the ID of the category you want to delete. |
Get a Category
Retrieves the category details.
Connection | Establish a connection to your Wordpress. |
Category ID | Enter (map) the ID of the category you want to retrieve information about. |
Search for a Category
Connection | Establish a connection to your Wordpress. |
Search term | Enter the search term. |
Limit | Set the maximum number of categories Integromat will return during one cycle. |
Comments
Watch Comments
Triggers when a new comment is posted.
Connection | Establish a connection to your Wordpress. |
Limit | Set the maximum number of comments Integromat will return during one cycle. |
Create a Comment
Creates a comment for a post.
Connection | Establish a connection to your Wordpress. |
Post ID | Enter (map) the ID of the post you want to create a comment for. |
Content | Enter the text content of the comment. |
Status | Set the status of the new comment. |
Author name | Enter a display name for the comment author. |
Author ID | Enter the ID of the user if the author of the comment is the user. |
Author email | Enter the email address for the comment author. |
Author IP | Set the comment author's IP address. |
Author URL | Enter the URL for the author of the comment. |
Author User-Agent | Enter the author User-Agent. E.g. Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:67.0) Gecko/20100101 Firefox/67.0 |
Parent object ID | Enter the ID of the parent object. |
Update a Comment
Allows you to modify an existing comment.
Connection | Establish a connection to your Wordpress. |
Comment ID | Enter (map) the ID of the comment you want to update. |
Please find the descriptions of the fields in the section Create a Comment above.
Delete a Comment
Deletes a specified comment.
Connection | Establish a connection to your Wordpress. |
Comment ID | Enter (map) the ID of the comment you want to delete. |
Get a Comment
Retrieves details of a specified comment.
Connection | Establish a connection to your Wordpress. |
Comment ID | Enter (map) the ID of the comment you want to retrieve information about. |
Search for a Comment
Searches for the comment and returns its details.
Connection | Establish a connection to your Wordpress. |
Search term | Enter the search term. |
Post ID | Enter the ID of the post to limit the result set to comments assigned to specific post IDs. |
Password | Enter the password for the post if it is password protected. |
Status | Select status to limit results to comments assigned to a specific status. |
Limit | Set the maximum number of comments Integromat will return during one cycle. |
Media
Watch Media Items
Triggers when new media is added to the library.
Connection | Establish a connection to your Wordpress. |
Limit | Set the maximum number of media items Integromat will return during one cycle. |
Create a Media Item
Adds new media to the media library.
Connection | Establish a connection to your Wordpress. |
Source file | Map the file from the previous module (e.g. Dropbox > Get a File), or enter the file name and file data to the respective fields. |
Title | Enter the media title. |
Slug | Set the slug for the new media item. |
Description | Enter the description of the media. |
Post ID | Enter the ID of the associated post of the media attachment. |
Author | Select the author of the media item. |
Date | Enter the date when the media item is published. List of supported date formats. |
Alternative text | Enter alt text to display when media is not displayed. |
Caption | Enter the attachment caption. |
Status | Select the status of the media item. |
Ping status | Select whether the media item can be pinged. |
Comment status | Set whether or not comments are open for the media item. |
Update a Media Item
Allows you to modify an existing media item.
Connection | Establish a connection to your Wordpress. |
Comment ID | Enter (map) the ID of the media item you want to update. |
Please find the descriptions of the fields in the section Create a Media Item above.
Delete Media Item
Deletes specified media.
Connection | Establish a connection to your Wordpress. |
Comment ID | Enter (map) the ID of the media item you want to delete. |
Get a Media Item
Retrieves the details for a specified media item.
Connection | Establish a connection to your Wordpress. |
Comment ID | Enter (map) the ID of the media item you want to retrieve information about. |
Search for a Media Item
Connection | Establish a connection to your Wordpress. |
Search term | Enter the search term. |
Limit | Set the maximum number of media items Integromat will return during one cycle. |
Users
Watch Users
Triggers when a new user is added.
Connection | Establish a connection to your Wordpress. |
Limit | Set the maximum number of users Integromat will return during one cycle. |
Create a User
Adds a new user.
Connection | Establish a connection to your Wordpress. |
Email address | Enter the email address of the new user. |
Username | Enter the login user name for the user you want to add. |
Password | Enter the password for the user. |
Display name | Enter the display name for the user. |
First name | Enter the user's first name. |
Last name | Enter the user's last name. |
Description | Enter the description for the user. |
Locale | Set the user's locale. E.g. en_US . |
Nickname | Enter the user's nickname. |
URL | Enter the user's website. |
Slug | Enter the alphanumeric identifier for the user. |
Roles | Select the roles you want to assign the user to. |
Update a User
Allows you to modify existing user information.
Connection | Establish a connection to your Wordpress. |
User ID | Enter (map) the ID of the user you want to update. |
Please find the descriptions of the fields in the section, Create a User above.
Delete a User
Deletes a specified user.
Connection | Establish a connection to your Wordpress. |
User ID | Enter (map) the ID of the user you want to delete. |
Reassign posts and links to user ID | Enter the user ID of another user to reassign the deleted user's posts and link it to this user ID. |
Get a User
Retrieves specified user details.
Connection | Establish a connection to your Wordpress. |
User ID | Enter (map) the ID of the user you want to retrieve information about. |
Search for a User
Searches for the user by the search term.
Connection | Establish a connection to your Wordpress. |
Search term | Enter the search term. |
Limit | Set the maximum number of users Integromat will return during one cycle. |
Tags
Watch Tags
Triggers when a new tag is added.
Connection | Establish a connection to your Wordpress. |
Limit | Set the maximum number of tags Integromat will return during one cycle. |
Create a Tag
Adds a new tag.
Connection | Establish a connection to your Wordpress. |
Name | Enter the name of the tag how it appears on your site. |
Description | Enter the tag description. The description is not prominent by default; however, some themes may show it. |
Slug | Enter the slug for the tag. The slug is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens. |
Update a Tag
Allows you to modify an existing tag.
Connection | Establish a connection to your Wordpress. |
Tag ID | Enter (map) the ID of the tag you want to update. |
Please find the descriptions of the fields in the section, Create a Tag above.
Delete a Tag
Deletes a specified tag.
Connection | Establish a connection to your Wordpress. |
Tag ID | Enter (map) the ID of the tag you want to delete. |
Get a Tag
Retrieves specified tag details.
Connection | Establish a connection to your Wordpress. |
Tag ID | Enter (map) the ID of the tag you want to retrieve information about. |
Search for a Tag
Connection | Establish a connection to your Wordpress. |
Search term | Enter the search term. |
Limit | Set the maximum number of tags Integromat will return during one cycle. |
Other
Get My Info
Returns the details of the authorized user.
Connection | Establish a connection to your Wordpress. |
Make an API Call
Allows you to perform a custom API call.
Connection | Establish a connection to your Wordpress. |
URL | Enter a path relative to For the list of available endpoints, refer to the WordPress REST API documentation. |
Method | Select the HTTP method you want to use: GET POST PUT PATCH DELETE |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
Example of Use - List Pages
The following API call returns all pages:
Matches of the search can be found in the module Output under Bundle > Body.
In our example, 8 pages were returned: