Rebrandly

Getting Started With Rebrandly

The Rebrandly modules allow you to monitor, publish, or update posts, photos, and videos in your Rebrandly account.

Prerequisites

  • A Rebrandly account

In order to use Rebrandly with {{Make}}, it is necessary to have a Rebrandly account. If you do not have one, you can create a Rebrandly account at app.rebrandly.com/sign-up.

[Note] Note

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

Connecting Rebrandly to {{Make}}

To connect your Rebrandly account to {{Make}}, follow these steps:

  1. Click on the Add button next to the Connection field of the desired Rebrandly module.

  2. Enter the name for the connection.

  3. Establish the connection by clicking the Continue button.

    61f278284256f.gif
Actions
Get Link

Retrieves link details.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select or map the workspace that contains the link you want to retrieve.

Link ID

Enter (map) the ID of the link you want to retrieve details about.

You can use the List Links module to retrieve the ID.

61f2782b363a5.png
Create Link

Creates a new link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace you want to create a link in.

Destination

Enter the destination URL you want your branded short link to point to.

Domain

Enter the Domain ID or Domain Name of the branded domain. When no ID or name is specified, http://rebrand.ly will be used as the domain.

Slashtag

The keyword part of your branded short link. If not specified, it will be autogenerated.

Must be a unique field for your workspace.

Allowed Character set: A-Z, a-z, 0-9, _ , - ( Min 1 chars Max 40 chars )
                           

Short Link Title

The title you assign to the branded short link in order to remember what's behind it.

Short Link Notes

A description/note you associate with the branded short link. Available only if your plan includes link notes.

Update Link

Changes the branded link settings.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace you want to update the link in.

Link ID

Select or map the link you want to update.

Please find the descriptions of the fields in the Create Link section above.

Delete Link

Deletes a specified link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select or map the workspace you want to delete the link from.

Link ID

Select or map the link you want to delete.

Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your Rebrandly account.

Enter a path relative to https://api.rebrandly.com/v1/.For example: links/577e253aa97e465d958505f9af7603a8

[Note] Note

For the list of available endpoints, please refer to the Rebrandly 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 need to add authorization headers; we've already done that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Links

The following API call returns all links in your Rebrandly account:

61f2782c69408.png

Matches of the search can be found in the module's Output under Bundle > Body.

In our example, 3 links were returned:

61f2782da3f1b.png
Get Domain

Retrieves domain details.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace you want to get a domain from.

Domain ID

Map or select the Domain ID of the domain you want to retrieve details about.

Get Tag

Retrieves tag details.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace you want to get tag details from.

Tag ID

Map or select the Tag ID of the tag you want to retrieve details about.

Create Tag

Creates a tag.

[Note] Note

The tag feature must be enabled in your plan in order to work with tags.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace you want to create a tag in.

Name

Enter the name for the tag with a minimum of 3 characters.

Color

Enter the 6 characters hexadecimal color value to set the color of the tag. E.g., ff9494

Update Tag

Changes the tag properties.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace that contains the tag you want to update.

Tag ID

Select or map the tag you want to update.

Please find the descriptions of the fields in the Create Tag section above.

Delete Tag

Deletes a tag from the selected workspace.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace that contains the tag you want to delete.

Tag ID

Select or map the tag you want to delete.

Attach Tag

Attaches a tag to the branded link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace that contains the tag you want to attach to the link.

Link ID

Select or map a link that the tag should be attached to.

Tag ID

Select or map the tag you want to attach to the link.

Detach Tag

Detaches a tag from the branded link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace that contains the tag you want to detach from the link.

Link ID

Enter a link that the tag should be detached from.

Tag ID

Enter or map the tag you want to detach from the link.

Get Script

Retrieves information about the script.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace that contains the script you want to retrieve details about.

Script ID

Map or select the script you want to retrieve details about.

Create Script

Creates a new script

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace you want to create a script in.

Name

Enter the unique name for the script.

Script

Javascript snippet including opening and closing <script> HTML tags. E.g.,

<script>alert('test');</script>                            
Update Script

Updates a script.

Connection

Establish a connection to your Rebrandly account.

Workspace

Select the workspace that contains the script you want to update.

Script ID

Select or map the script you want to update.

Name

Enter the new unique name for the script.

Script

Enter new Javascript snippet including opening and closing <script> HTML tags. E.g.,

 <script>alert('test');</script>
Delete Script

Deletes a script.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace that contains the script you want to delete.

Script ID

Select or map the script you want to delete.

Attach Script

Attaches a script to the branded link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace that contains the script you want to attach to the link.

Link ID

Select or map the link that the script should be attached to.

Script ID

Select or map the script you want to attach to the link.

Detach Script

Detaches a script from the branded link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace that contains the script you want to detach from the link.

Link ID

Enter (map) or select a link that the script should be detached from.

Script ID

Enter (map) or map the script you want to detach from the link.

Searches
List Links

Returns all links from the specified workspace.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace you want to list links from.

Limit

Set the maximum number of links {{Make}} will return during one execution cycle.

Filter by domain ID

Add (map) domains to filter links which refer to a specific branded domain.

Filter by domain name

Filter branded short links that refer to a specific branded domain's name.

E.g., rebrand.ly/HowTo{{Make}}, where 'rebrand.ly' is the domain name.

Filter by slashtag

Enter the slashtag to filter links by. When the slashtag is entered, the Filter by domain ID or Filter by domain name fields must be also defined.

E.g., rebrand.ly/HowTo{{Make}}, where 'HowTo{{Make}}' is the slashtag.

Filter by creator ID

Enter the ID to filter branded short links which have been created by a specific teammate ID.

Order By

Select whether to sort results by title, created at, updated at, or slashtag.

Sort ascending or descending

Select the sort order.

Favorite only

Returns only branded links marked as favorite.

List Workspaces

Retrieves all workspaces in your account.

Connection

Establish a connection to your Rebrandly account.

Limit

Set the maximum number of workspaces {{Make}} will return during one execution cycle.

Order By

Select whether to sort results by name, created at, or updated at.

Sort ascending or descending

Select the sort order.

List Domains

Returns all domains that are used within the workspace.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace you want to list domains from.

Limit

Set the maximum number of domains {{Make}} will return during one execution cycle.

Active domains only

Filters branded domains depending on whether they can be used to brand short links or not.

Filter by type

Select whether to filter branded domains depending on their type (owned by user or service domains like rebrand.ly)

Order By

Select whether to sort results by domain full name, created at, or updated at.

Sort ascending or descending

Select the sort order.

List Tags

Retrieves all tags within the workspace.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace you want to list tags from.

Limit

Set the maximum number of tags {{Make}} will return during one execution cycle.

Sort ascending or descending

Select the sort order.

List Scripts

Retrieves all scripts within the workspace.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace you want to list scripts from.

Limit

Set the maximum number of scripts {{Make}} will return during one execution cycle.

Sort ascending or descending

Select the sort order.

List Link Tags

Retrieves all tags from the selected link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace you want to list tags from.

Link ID

Select or map the link you want to list tags from.

Limit

Set the maximum number of tags {{Make}} will return during one execution cycle.

List Link Scripts

Retrieves all scripts from the selected link.

Connection

Establish a connection to your Rebrandly account.

Workspace

Map or select the workspace you want to list scripts from.

Link ID

Select or map the link you want to list scripts from.

Limit

Set the maximum number of scripts {{Make}} will return during one execution cycle.

Troubleshooting -

Module - Create a Link

Error Code - Invalid Link format [ 403 ]

Checks -

  1. Make sure the destination URL is valid and doesn't have any space or invalid character.

  2. Check Slashtag -

  • This field only allows the following character set:

    A-Z, a-z, 0-9, _, -                               

    Min 1 char - Max 40 chars.

  • Must be a unique field for your workspace.