Orbit

Orbit User Guides

Check out these guides and resources for getting the most out of Orbit. Email [email protected] with any questions or feedback. Let's jump right in!

Get Started    API Reference

Orbit Zapier Zap examples

Prerequisites

You’ll need your API Token, which you can grab from your settings page inside Orbit.

You should also have the Orbit API Documentation handy.

Finally, add the Orbit Zapier app (beta) to your Zapier account here.


Setup the Orbit Zapier app

The first time you use the Orbit app, you’ll be asked to enter the URL slug of your workspace name and your API key.

Find your workspace slug in the URL bar; it's what comes after https://app.orbit.love/, e.g. https://app.orbit.love/**your-workspace-slug**

🚧

Do not forget to include [https://app.orbit.love/](https://app.orbit.love/) in the Workspace Name input.

Find your API key on the Account Settings page.


Connect Eventbrite registrations to Orbit

📘

Copy this zap

Start by adding the Eventbrite app and authenticating your account.

Select your organization and set Event Status to All.

If you want to manage all of your event registrations in Orbit, leave the Event box blank. Otherwise, select an event to manage a specific event.

Click Find Data to load data for testing the next step:

For the second step, choose the Orbit app, and select Create Activity:

Here’s how we configured the attributes for the new activity:

The resulting Activity in Orbit will look like this:


Add new Slack signups to Orbit

📘

Copy this zap

Inside of Zapier, create a new Zap with Slack as the first step, and select “New User.”

For the second step, choose the Orbit app, and select Create Activity:

In the Customize Activity section, do the following:

  • Activity title: Joined our Slack
  • Tags: we add the optional tag Slack so we can quickly filter by Slack community members inside Orbit
  • Member email: pull this in from the Slack step:

Only the Activity title is required.

Now, scroll down and click Send Data, then click the Retest and Review button to send a test payload to Orbit. If it works, you’ll see “Test was successful!”

Navigate to your workspace Activities screen and you should see the results of the test:

At this point, you’ve successfully connected your Slack group to your Orbit workspace. Now let’s take it one step further.

Receive notifications when someone joins your community Slack

So far, you’ve connected your community Slack to your Orbit workspace. Now, let’s have Orbit send a notification to your company workspace to let you know that you have a new community member.

Add a third step to your zap using the Send Channel Message action and the Slack zap.

In the Customize Channel Message section, we get to have a little fun.

The Message Text section is what will appear in your channel or DM when you send the notification.

First, you’ll notice we’re using custom icons like orbit-fire and orbit-starbot. You can use any emoji you’d like, but if you want to use ours, download the set here.

The message text is a mix of info from Slack and from Orbit. The /activities endpoint will return a number of attributes for the member, which we then pass into this message. This includes their bio (if any), company (if any), and their Reach.

We also include a direct link to their member profile page in Orbit, which is a really useful method for quickly accessing more info.

This results in a notification that looks like this:

Common issues

“is required and must be valid”

This error usually means the zap didn't send Orbit an email address, Twitter username, or GitHub username.

Alternatively, if you're trying to resolve a Twitter or GitHub username, Orbit will first determine if that user exists on the platform in question. If it does not, Orbit will not create a Member and Activity and will throw this error.

404

This is usually related to authentication. Navigate to https://zapier.com/app/connections and try reconnecting the Orbit app. Ensure you've correctly entered your Workspace Name (just the part of the URL after .love/) and your API token.

Updated 12 days ago

Orbit Zapier Zap examples


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.