• Documentation >
• Apps >
• Marketing >
• Tumblr

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 Ibexa Connect, it is necessary to have a Tumblr account. If you do not have one, you can create a Tumblr account at www.tumblr.com.

Connecting Tumblr to Ibexa Connect

1. Go to Ibexa Connect 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, Ibexa Connect will redirect you to the Tumblr website where you will be prompted to grant Ibexa Connect 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.

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 Ibexa Connect will return during one execution cycle.

Watch Liked Posts

Retrieves details of the posts that you liked.

Limit	Set the maximum number of posts Ibexa Connect will return during one execution cycle.

Watch Tagged Posts

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

Tag	Enter the tag you want to filter returned posts by.
Limit	Set the maximum number of posts Ibexa Connect will return during one execution cycle.

Create a Post

Creates a new post.

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.

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

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.

Make an API Call

Allows you to perform a custom API call.

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.

Example of Use - List Published Posts

The following API call returns all published posts in your Tumblr account:

URL:

/v2/blog/{your-blog-url}/posts/

Method:

GET

The result can be found in the module's Output under Bundle > Body > dashboards.

In our example, 5 posts were returned: