Blackbird Remote Connector

Remote is an available app in Blackbird.io’s platform, allowing you to automate workflows across apps using Blackbird’s no-code automation platform. Blackbird is tailored for the global language services industry, enabling integration, automation, and seamless analytics between the apps, data, content, participants, and devices used for localization and globalization management. Remote customers who manage a large volume of contractors and contractor invoices in the platform can benefit from Blackbird by integrating Remote with their translation management system, money transfer system, CMS, and more. You can see a full list of available apps in Blackbird’s documentation and see use cases and inspiration for how to use the Remote connector in their guide.

To make use of Blackbird’s integrations, you will need to be a customer of both Remote, Blackbird, and the apps you want to connect Remote to.

Before setting up

Before you can connect you need to make sure that:

• You have a Remote instance
• You have a Remote API token. You can find a detailed guide on how to get it here. Notice that only Admins and the Owner can create and revoke API token

Connecting Remote to other apps in Blackbird

1. In Blackbird, navigate to Apps, and identify the Remote app. You can use search to find it.
2. Click Add Connection.
3. Name your connection for future reference e.g. ‘My Remote connection’.
4. Fill in the Base URL field. If you are using production environment, you should use https://gateway.remote.com. If you are using sandbox environment, you should use https://gateway.remote-sandbox.com.
5. Fill in the API token you got from Remote.
6. Click Connect.
7. Make sure that connection was added successfully.

Create specific actions to occur when a specified trigger activates them

Because Blackbird is an iPaas (integration platform as a service) all integrations between Remote and other apps are designed by the end customer. Actions are tasks that will be created once a trigger activates them. Review Blackbird’s documentation to understand how to set up automations and leverage actions. Blackbird has leveraged specific Remote API endpoints so that you can design workflows for the actions below:

Employees

• Search employments Search employments based on specified criteria.
• Get employment Get employment by ID.
• Create employment Create employment with specified data.
• Update employment Update employment by ID with specified data.
• Invite employment Invite employment by ID to start the self-enrollment
• Get employment custom field Get employment custom field value by ID

Invoices

• Search invoices Search invoices based on specified criteria.
• Get invoice Get invoice by ID.

Invoice schedules

• Search invoice schedules Search сontractor invoice schedules based on specified criteria.
• Get invoice schedule Get сontractor invoice schedule by ID.
• Create invoice schedule Create сontractor invoice schedule with specified data.
• Update invoice schedule Update сontractor invoice schedule by ID with specified data.
• Import invoice schedule Import сontractor invoice schedules from a JSON file. You can export this file from the Plunet app for example.

The Remote API processes amounts in cents rather than in the standard currency format. This means that any amount returned by the API will be in cents. For example, an amount of $800 will be represented as 80,000 cents in the API outputs.

Time offs

• Get time off returns details of a specific time off.
• Create time off creates a new time off for the employee.

Expenses

• Create expense creates a new expense.

Set events you want to occur based off a specified trigger

Events are the things that can happen inside the app you’re connected to (either Remote or the app you’re connecting Remote to). The event will start your automated workflow. Blackbird has leveraged specific Remote API endpoints so that you can design workflows for the events below:

Employments

• On employment activated This event is triggered whenever an employment user is updated to the active status.
• On employment onboarding completed This event is triggered whenever an employment user has completed onboarding.
• On employment details updated This event is triggered whenever an employment user’s details are updated.
• On employment personal information updated This event is triggered whenever an employment user’s personal information is updated.
• On employment status deactivated This event is triggered whenever an employment user status is updated to inactive.

Time offs

• On time off canceled Triggers when a time off is canceled.
• On time off declined Triggers when a time off is declined.
• On time off requested Triggers when a time off is requested.
• On time off date changed Triggers when a time off has its date changed.

Custom fields

• On custom field value updated This event is triggered whenever a custom field value is updated.

Invoices

• On invoices status changed This event returns invoices that changed status since the last polling time.

Note: Invoice events are based on polling. This means that the event will be triggered based on the polling interval you set in the event configuration.

To get support with your Blackbird connector, reach out to the Blackbird support team.