WordPress (legacy)

Version Legacy

This is the documentation for the legacy WordPress app.
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 or web.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.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

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.

VGOtTtgsKW.gif

3. Click the Add New button.

4. Click on the Upload plugin button, browse and select the plugin ZIP file.

7L674VRq5c.gif

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.

2019-05-28_15_33_47-Integration_WordPress___Integromat.png

If the connection is not established and an error is returned, you need to add the following code to your .htaccessfile 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.

VGOtTtgsKW.gif

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.

2019-06-11_15_43_56-Window.png

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.

qJQlIR5FDf.gif

10. Click on the Save Settings button.

11. The selected custom fields are now available in the module response.

2019-06-11_15_53_07-Integration_Salesflare___Integromat.png

Posts

Watch Posts

Triggers when a new object (post, page, or media) is added.

ConnectionEstablish a connection to your Wordpress.
TypeSelect whether you want to retrieve newly added posts, pages, or media.
LimitSet the maximum number of objects Integromat will return during one cycle.

Create a Post

Creates an object.

ConnectionEstablish a connection to your Wordpress.
TypeSelect whether you want to retrieve newly added posts, pages, media, or another object.
TitleSet the post's title.
ContentEnter the content of the new post. HTML is allowed.
ExcerptEnter the excerpt content for the post.
DateEnter the date of the new post. List of supported date formats.
SlugEnter the post's slug (in order to have more SEO-friendly URL).
StatusSet the status of the new post. If no status is selected the post's status will be set to draft.
FormatSelect one of the formats for the post. For more information about post formats refer to wordpress.org/support/article/post-formats.
PasswordSet the password if you want the post password protected.
StickySet whether or not the object should be treated as sticky.
CategoriesSelect categories that a new post should belong to.
TagsSelect tags for the new post.
AuthorSet 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 statusSet whether or not comments are open on the post.
Ping statusSet whether the post can be pinged.

Update a Post

Allows you to modify the existing post.

ConnectionEstablish 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, ...)

ConnectionEstablish 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.

ConnectionEstablish a connection to your Wordpress.
TypeSelect 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.

ConnectionEstablish a connection to your Wordpress.
TypeSelect the type of post you want to search.
Search term
Enter the search term.
LimitSet the maximum number of results Integromat will return during one cycle.

Pages

Watch pages

Triggers when a new page is published.

ConnectionEstablish a connection to your Wordpress.
LimitSet the maximum number of pages Integromat will return during one cycle.

Create a Page

Creates a page.

ConnectionEstablish a connection to your Wordpress.
TitleSet the page's title.
ContentEnter the content of the new post. HTML is allowed.
DateEnter the date of the new page. List of supported date formats.
SlugEnter the page's slug (in order to have a more SEO-friendly URL).
StatusSet the status of the new page. If no status is selected the page's status will be set to draft.
PasswordSet the password if you want the page password protected.
Parent object IDEnter the ID of the parent object, if needed.
AuthorSet 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 statusSet whether or not comments are open on the page.
Ping statusSet whether the page can be pinged.

Update a page

Allows you to modify the existing page.

ConnectionEstablish 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.

ConnectionEstablish 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.

ConnectionEstablish 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.

ConnectionEstablish a connection to your Wordpress.
Search term
Enter the search term.
LimitSet the maximum number of pages Integromat will return during one cycle.

Categories

Watch Categories

Triggers when a new page is created.

ConnectionEstablish a connection to your Wordpress.
LimitSet the maximum number of categories Integromat will return during one cycle.

Create a Category

Adds a new category.

ConnectionEstablish a connection to your Wordpress.
NameEnter the name of the category and how it appears on your site.
DescriptionEnter the text for the description.
The description is not prominent by default; however, some themes may show it.
SlugEnter 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 IDEnter the ID of the parent category in the case where you want to create a child category.

Update a Category

Modifies an existing category.

ConnectionEstablish 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.

ConnectionEstablish 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.

ConnectionEstablish a connection to your Wordpress.
Category ID
Enter (map) the ID of the category you want to retrieve information about.

Search for a Category

ConnectionEstablish a connection to your Wordpress.
Search term
Enter the search term.
LimitSet the maximum number of categories Integromat will return during one cycle.

Comments

Watch Comments

Triggers when a new comment is posted.

ConnectionEstablish a connection to your Wordpress.
LimitSet the maximum number of comments Integromat will return during one cycle.

Create a Comment

Creates a comment for a post.

ConnectionEstablish a connection to your Wordpress.
Post ID
Enter (map) the ID of the post you want to create a comment for.
ContentEnter the text content of the comment.
StatusSet the status of the new comment.
Author nameEnter a display name for the comment author. 
Author IDEnter the ID of the user if the author of the comment is the user.
Author emailEnter the email address for the comment author. 
Author IPSet the comment author's IP address.
Author URLEnter the URL for the author of the comment.
Author User-AgentEnter 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 IDEnter the ID of the parent object.

Update a Comment

Allows you to modify an existing comment.

ConnectionEstablish 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.

ConnectionEstablish 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.

ConnectionEstablish 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.

ConnectionEstablish a connection to your Wordpress.
Search term
Enter the search term.
Post IDEnter the ID of the post to limit the result set to comments assigned to specific post IDs.
PasswordEnter the password for the post if it is password protected.
StatusSelect status to limit results to comments assigned to a specific status.
LimitSet the maximum number of comments Integromat will return during one cycle.

Media

Watch Media Items

Triggers when new media is added to the library.

ConnectionEstablish a connection to your Wordpress.
LimitSet the maximum number of media items Integromat will return during one cycle.

Create a Media Item

Adds new media to the media library.

ConnectionEstablish 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.
TitleEnter the media title.
SlugSet the slug for the new media item.
DescriptionEnter the description of the media.
Post IDEnter the ID of the associated post of the media attachment.
Author
Select the author of the media item.
DateEnter the date when the media item is published. List of supported date formats.
Alternative textEnter alt text to display when media is not displayed. 
CaptionEnter the attachment caption.
StatusSelect the status of the media item.
Ping statusSelect whether the media item can be pinged.
Comment statusSet whether or not comments are open for the media item.

Update a Media Item

Allows you to modify an existing media item.

ConnectionEstablish 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.

ConnectionEstablish 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.

ConnectionEstablish 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

ConnectionEstablish a connection to your Wordpress.
Search term
Enter the search term.
LimitSet the maximum number of media items Integromat will return during one cycle.

Users

Watch Users

Triggers when a new user is added.

ConnectionEstablish a connection to your Wordpress.
LimitSet the maximum number of users Integromat will return during one cycle.

Create a User

Adds a new user.

ConnectionEstablish a connection to your Wordpress.
Email address
Enter the email address of the new user.
UsernameEnter the login user name for the user you want to add.
PasswordEnter the password for the user.
Display name
Enter the display name for the user.
First nameEnter the user's first name.
Last nameEnter the user's last name.
DescriptionEnter the description for the user.
LocaleSet the user's locale. E.g. en_US.
NicknameEnter the user's nickname.
URLEnter the user's website.
SlugEnter the alphanumeric identifier for the user.
RolesSelect the roles you want to assign the user to.

Update a User

Allows you to modify existing user information.

ConnectionEstablish 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.

ConnectionEstablish a connection to your Wordpress.
User ID
Enter (map) the ID of the user you want to delete.
Reassign posts and links to user IDEnter 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.

ConnectionEstablish 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.

ConnectionEstablish a connection to your Wordpress.
Search term
Enter the search term.
LimitSet the maximum number of users Integromat will return during one cycle.

Tags

Watch Tags

Triggers when a new tag is added.

ConnectionEstablish a connection to your Wordpress.
LimitSet the maximum number of tags Integromat will return during one cycle.

Create a Tag

Adds a new tag.

ConnectionEstablish a connection to your Wordpress.
NameEnter the name of the tag how it appears on your site.
DescriptionEnter the tag description. The description is not prominent by default; however, some themes may show it.
SlugEnter 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.

ConnectionEstablish 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.

ConnectionEstablish 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.

ConnectionEstablish a connection to your Wordpress.
Tag ID
Enter (map) the ID of the tag you want to retrieve information about.

Search for a Tag

ConnectionEstablish a connection to your Wordpress.
Search term
Enter the search term.
LimitSet the maximum number of tags Integromat will return during one cycle.

Other

Get My Info

Returns the details of the authorized user.

ConnectionEstablish a connection to your Wordpress.

Make an API Call

Allows you to perform a custom API call.

ConnectionEstablish a connection to your Wordpress.
URL

Enter a path relative to https://{DOMAIN}/wp-json/wp/v2/. E.g. posts/1

For the list of available endpoints, refer to the WordPress REST API documentation.
Method

Select the HTTP method you want to use:

GET
to retrieve information for an entry.

POST
to create a new entry.

PUT
to update/replace an existing entry.

PATCH
to make a partial entry update.

DELETE
to delete an entry.

HeadersEnter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query StringEnter the request query string.
BodyEnter the body content for your API call.

Example of Use - List Pages

The following API call returns all pages:

2019-06-20_11_46_36-Window.png

Matches of the search can be found in the module Output under Bundle > Body
In our example, 8 pages were returned:

2019-06-20_11_48_19-Window.png


Popular use cases from our blog

automated-data-collection-crm-illustration

How to Automate Data Collection - Part 5: CRM Systems

automated-data-collection-chatbot-marketing-illustration

How to Automate Data Collection - Part 4: Chatbot Marketing

automated-data-collection-paid-ads-illustration

How to Automate Data Collection - Part 3: Paid Ads

automated-data-collection-email-illustration

How to Automate Data Collection - Part 2: Email Marketing Segmentation

personalized-customer-experience-illustration-integromat

5 Automated Solutions to Personalize Customer Experience

data-collection-automation-forms-pt-1

How to Automate Data Collection - Part 1: Online Forms

Didn’t find what you were looking for?

Ticket

Create a ticket

Contact our world-class support team and tell us what’s happening.

Create a ticket
Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.