GatherContent
With the GatherContent modules, you can do the following in your GatherContent account.
Watch, list, retrieve and create the projects.
Watch, list, retrieve, create, rename, and move the items.
Watch new statuses, accounts, and templates.
To get started with the GatherContent, create an account at gathercontent.com
Note
The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!
Connect GatherContent with Make
To connect the GatherContent app with the Make:
Log in to your GatherContent account.
Click Profile Name > Personal Settings > API.
Click Generate new API key.
In the Description field, enter the details of the API key and in the Password field, enter your GatherContent account password. Click Generate.
Copy the API Key to a safe place.
Log in to your Make account and add a module from the GatherContent into a Make scenario.
Click Add next to the Connection field.
In the Connection name field, enter a name for the connection.
In the E-mail field, enter your GatherContent account email address.
In the API Key field, enter the API Key copied in step 5, and click Save.
You have successfully connected the GatherContent app with Make and can now build scenarios.
Projects
You can watch, list, retrieve, and create the projects using the following modules.
Watches for projects.
Connection | |
Account ID | Select or map the Account ID whose new projects you want to watch. |
Limit | Set the maximum number of projects Make should return during one execution cycle. The default value is 2. |
List projects.
Connection | |
Account ID | Select or map the Account ID whose projects you want to list. |
Limit | Set the maximum number of projects Make should return during one execution cycle. The default value is 10. |
Returns a specified project.
Connection | |
Account ID | Select or map the Account ID whose project details you want to retrieve. |
Project ID | Select or map the Project ID whose details you want to retrieve. |
Creates a new project.
Connection | |
Account ID | Select or map the Account ID whose project you want to create. |
Name | Enter (map) a name for the project. |
Type | Select or map the project type. For example, website. |
Items
You can watch, create, list, retrieve, rename, and move an item using the following modules.
Watches for items.
Connection | |
Account ID | Select or map the Account ID whose project's items you want to watch. |
Project ID | Select or map the Project ID whose items you want to watch. |
Limit | Set the maximum number of items Make should return during one execution cycle. |
List items or search for them by specified parameters.
Connection | |
Account ID | Select or map an Account ID whose project items you want to list. |
Project ID | Select or map a Project ID whose items you want to list. |
Status IDs | Select or map the Status IDs of the items you want to list. |
Template IDs | Select or map the Template IDs to list the items that match the specified template. |
Folder UUID | Select or map the Folder UUID to list the items that match the specified folder. |
Item IDs | Select or map the Item IDs you want to list. |
Include | Select or map the option you want to include in the list. |
With Due Dates | Select whether to include items with due dates in the response. |
With Conversation Count | Select whether to return the number of conversations on each item in the response. |
Is Overdue | Select whether to return only the overdue items. |
Is Archived | Select whether to return only the archived items. |
Assigned to | Enter (map) the User ID to filter the items with the assigned User ID. You can add multiple users. |
Name Contains | Enter (map) the keywords, or characters to filter the items matching the specified words or characters. |
Sort by | Select or map the option to sort the items. For example, name. |
Sort Direction | Select the order to sort the items:
|
Limit | Set the maximum number of items Make should return during one execution cycle. The default value is 10. |
Returns a specified item.
Connection | |
Account ID | Select or map the Account ID whose project item details you want to retrieve. |
Project ID | Select or map the Project ID whose item details you want to retrieve. |
Item ID | Select or map the Item ID whose details you want to retrieve. |
Include Structure? | Select whether to include the item structure in the details. |
Creates a new item.
Connection | |
Account ID | Select or map the Account ID whose project item you want to create. |
Project ID | Select or map the Project ID for which you want to create the item. For example, website. |
Template ID | Select or map the Template ID to apply to the item. |
Status ID | Select or map the Status ID of the item. For example, Draft. |
Folder UUID | Select or map the Folder UUID for the item. If no folder is provided, the item will be created in the project's root folder. |
Name | Enter (map) the item name. |
Position | Enter (map) a position for the item against the list of existing items. The default position is at the end of the existing items within its folder. |
Updates the name of the specified item.
Connection | |
Account ID | Select or map the Account ID whose item name you want to rename. |
Project ID | Select or map the Project ID whose item's name you want to rename. |
Item ID | Select or map the Item ID to rename. |
Name | Enter (map) a new name for the item. |
Applies a specific status to an existing item.
Connection | |
Account ID | Select or map the Account ID whose item status you want to update. |
Project ID | Select or map the Project ID whose item status you want to update. |
Item ID | Select or map the Item ID whose status you want to update. |
Status ID | Select or map the item's new Status ID. |
Moves an existing item.
Connection | |
Account ID | Select or map the Account ID whose project item you want to move. |
Project ID | Select or map a Project ID whose item you want to move. |
Item ID | Select or map the Item ID whose position you want to change. |
Folder UUID | Select or map a Folder UUID to which you want to move the item. |
Position | Enter (map) the new desired position in the folder, zero-indexed. |
Triggers
You can watch new statuses, new accounts, and new templates using the following modules.
Watches for statuses.
Connection | |
Account ID | Select or map the Account ID whose project statuses you want to watch. |
Project ID | Select or map the Project ID whose statuses you want to watch. |
Limit | Set the maximum number of statuses Make should return during one execution cycle. The default value is 10. |
Watches for accounts.
Connection | |
Limit | Set the maximum number of accounts Make should return during one execution cycle. The default value is 2. |
Watches for templates.
Connection | |
Account ID | Select or map the Account ID whose project templates you want to watch. |
Project ID | Select or map the Project ID whose new templates you want to watch. |
Limit | Set the maximum number of templates Make should return during one execution cycle. The default value is 2. |
Other
You can call APIs using the following module.
Performs an arbitrary authorized API call.
Connection | |
URL | Enter a path relative to NoteFor the list of available endpoints, refer to the GatherContent API Documentation. |
Method | 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. |
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 - Get User Details
The following API call returns the logged in user details in your GatherContent account:
URL:
/request
Method:
GET
Matches of the search can be found in the module's Output under Bundle > Body > data.
In our example, the logged in user details were returned:
Note
For some modules, you may have to change the API version in the Header section.