Tumblr

The Tumblr modules enable you to watch, create, update, list, and delete posts in your Tumblr account.

Getting Started with Tumblr

Prerequisites

A Tumblr account

In order to use Tumblr with Integromat, it is necessary to have a Tumblr account. If you do not have one, you can create a Tumblr account at www.tumblr.com.

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

Connecting Tumblr to Integromat

1. Go to Integromat and open the Tumblr module's Create a connection dialog.

2. Enter the name of the connection to the Connection name field and click Continue.

After you click the Continue button, Integromat will redirect you to the Tumblr website where you will be prompted to grant Integromat access to your account.

3. Confirm the dialog by clicking the Allow button.

Posts

Watch Posts

Retrieves post details when a new post is posted.

Connection	Establish a connection to your Tumblr account.
Blog	Select the blog you want to watch for new posts.
Type	Select the type of post you want to return. No option selected – returns all types.
Limit	Set the maximum number of posts Integromat will return during one execution cycle.

Watch Liked Posts

Retrieves details of the posts that you liked.

Connection	Establish a connection to your Tumblr account.
Limit	Set the maximum number of posts Integromat will return during one execution cycle.

Watch Tagged Posts

Retrieves details of a post that is tagged with a specified tag.

Connection	Establish a connection to your Tumblr account.
Tag	Enter the tag you want to filter returned posts by.
Limit	Set the maximum number of posts Integromat will return during one execution cycle.

Create a Post

Creates a new post.

Connection Establish a connection to your Tumblr account.

Blog Select or map the blog you want to create a new post for.

Type

Select the type of the new post.

Text

Title	Enter the post title.
Body	Enter the text content of the post. HTML supported.

Quote

Quote	Enter the text content of the quotation.
Source	Specify the source of the quote. HTML supported.

Chat

Title	Enter the chat title
Conversation	Enter the text content of the conversation.

Link

Title	Enter the title of the page the link points to.
URL	Enter the link.
Description	Enter the description of the link. HTML supported.
Thumbnail	Enter the URL of an image to use as a thumbnail for the post.
Excerpt	Enter an excerpt from the page the link points to.
Author	Enter the name of the author from the page the link points to.

Photo

Caption

Enter the caption for the photo.

Link

Enter the "click-through URL" for the photo.

Upload Photo

Select whether you want to upload the photo from an external URL or map the image data.

External URL	Enter the source URL of the photo.
Source File / Photos	Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Google Drive > Download a File), or enter the file name and file data manually.

Audio

Caption

Enter the caption for the audio.

Upload Audio

Select whether you want to upload the audio file from an external URL or map the audio data.

External URL	Enter the source URL of the audio.
Source File	Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Google Drive > Download a File), or enter the file name and file data manually.

Video

Caption

Enter the caption for the video.

Upload Video

Select whether you want to provide a video file from the embed code or map the video data.

Embed	Enter the HTML embed code for the video or a URI to the video. If you provide an unsupported service's URI, you may receive a 400 response.
Source File	Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Google Drive > Download a File), or enter the file name and file data manually.

State

Select the new post state. Default is Published.

Published means the post should be publicly published immediately.
Queue means the post should be added to the end of the blog's post queue.
Draft means the post should be saved as a draft.
Private means the post should be privately published immediately.

Tags Enter tags you want to associate with the post.

Send to Twitter Select Yes to share the post via any connected Twitter account when the post is published. Defaults to the blog's global setting.

Publish On

Enter the exact date and time (ISO 8601 format) to publish the post, if desired. This parameter will be ignored unless the State field is Queue. The list of supported date and time formats.

Format Select the format type of the post.

Slug Enter a short text summary to the end of the post URL.

Native inline images Select the Yes option to Convert any external image URLs to Tumblr image URLs.

Update a Post

Updates an existing post.

Connection	Establish a connection to your Tumblr account.
Blog	Select or map the blog you want to update the post for.
Post ID	Enter (map) the ID of the post you want to update.

Please find the descriptions of the fields in the Create a Post section above.

Delete a Post

Connection	Establish a connection to your Tumblr account.
Blog	Select or map the blog you want to delete the post from.
Post ID	Enter (map) the ID of the post you want to delete.

Other

Get User Info

Retrieves user account details.

Connection

Establish a connection to your Tumblr account.

Make an API Call

Allows you to perform a custom API call.

Connection	Establish a connection to your Tumblr account.
URL	Enter a path relative to `https://api.tumblr.com/`. For example: `/v2/user/info`. For the list of available endpoints, refer to the Tumblr 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.
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.