Documentation
Connect third-party forms to receive new submissions to Program
If you want to ask your members to fill out an application form to be considered for your Program, Orbit supports different ways to connect your form to receive applications to your Program.
This article will show how to connect a Google form, a Typeform, a Webflow form, or an HTML Form that you have on your website to allow your members to apply to your Program.
Webflow
To connect a Webflow form to your Program in Orbit, follow these steps:
- Create or edit your form, and be sure to include the required fields (see Supported fields).
- Find the form POST URL for your Program. To do so, navigate to your Program in Orbit and click on “Add member” then “Form Submission” in the top-right. On the new page, choose Webflow. The POST URL will be displayed there.
- On your form in Webflow, click on the Form Settings icon, and add the URL copied to the “Action” field.
- Lastly, make sure that the “Method” in the Webflow Form Settings is set to “POST” (and not “GET”).
Typeform
To receive applications from a Typeform, follow these steps:
- Create or edit your form, and be sure to include the required fields (see Supported fields).
- Find the webhook URL for your Program. To do so, navigate to your Program in Orbit and click on “Add member” then “Form Submission” in the top-right. On the new page, choose Typeform. The webhook URL will be displayed there.
- On your form edit page on Typeform, click, “Connect” then “Webhook”, and “Add webhook”.
- Paste the webhook endpoint URL from Orbit and save it.
- Lastly, activate the webhook (switch it from OFF to ON).
Google Form
To receive applications from a Google form, follow these steps:
- Create or edit your form, and be sure to include the required fields (see Supported fields).
- Find the Google script for your Program. To do so, navigate to your Program in Orbit and click on “Add member” then “Form Submission” in the top-right. On the new page, choose Google Form. The Google script will be displayed there.
- On your form edit page on Google Forms, click the 3 dots in the top-right then “Script editor”.
- Paste the script in the Script editor, click “Deploy” then “New deployment”.
- In the deployment configuration, select “Web app” for the type, and enter a description. For “Execute as”, select “Me”, and for “Who has access”, select “Anyone”, and click “Deploy”.
- Once the deployment is complete, click “Triggers” in the left menu.
- On the Triggers page, click “Add Trigger”. In the trigger configuration, select “sendToOrbit” for the function to run, then select the version of deployment to run. For the event source, select “From form”, and “On form submit” for the event type. Click “Save” to add the trigger.
HTML Form
- Create the HTML for the form. Here is a template to get you started:
<form action='[POST URL]' method='POST'>
<label name='name'>Name</label>
<input type='text' id='application-name' name='name' />
<label name='email'>Email</label>
<input type='text' id='application-email' name='email' />
<label name='twitter'>Twitter Username</label>
<input type='text' id='application-twitter' name='twitter' />
<label name='why join'>Why do you want to join this program?</label>
<input type='text' id='application-question-1' name='why join' />
<button type='submit'>Submit</button>
</form>
- Find the Form POST URL for your Program. To do so, navigate to your Program in Orbit and click on “Add member” then “Form Submission” in the top-right. On the new page, choose HTML Form. The form POST URL will be displayed there.
- In the template code above, replace “[POST URL]” with your form POST URL, and be sure to include the required fields (see Supported fields). You can add as many additional application questions as you want as new inputs.
- Host this form on your webpage so your members can start applying!
Zapier
The Orbit Zapier app gives you the ability to connect your Orbit workspace to numerous third-party services.
In this guide, we will walk through setting up the app for the first time in Zapier and connecting a Program to Typeform. The same workflow principles will apply with Google Form, and any other service providing forms creation. Be sure that your form includes the required fields (see Supported fields).
- Start creating a new zap. Select the third-party app you want to connect, and the trigger event. The latter must be the event that occurs when the form is submitted.
- Grant Zapier access to your Typeform account. You’ll be asked to Sign in.
- Choose the form in your account you want to connect
- Test the trigger. Zapier will collect the most recent entry in your form to test if the connection works. If you don't have any entry in the form, you will need to create one.
- Select Orbit for the Action, and for the action event, select “Create a Submission to a Program”.
- Grant Zapier access to your Orbit account. You’ll be asked to enter the ”Workspace Name” and your ”API Token”.
- Create a new API token. To do so, navigate to your workspace settings page in Orbit and click on “API Tokens” then “New API Token”. Enter a name, and a description and click “Create”. Once the API token has been created, click on its name in the list of API tokens, and click "Copy”.
- Paste the API token, and the workspace name, and finish the connection with Orbit.
- Find the public UUID for your Program. To do so, navigate to your Program in Orbit and click on “Add member” then “Form Submission” in the top-right. On the new page, choose Zapier. The public UUID will be displayed there.
- Continue the process on Zapier, and paste the public UUID.
- In the "Form response" section, select an answer in the right field and enter the question in the left field. You must do this for each question and answer you want to send to Orbit. Be sure that you include the required fields (see Supported fields).
- Test the action. Zapier will send the responses to Orbit and you should see a new application to your Program.
- Publish your zap to receive new form submissions into Orbit.
Supported Form Fields
Orbit supports the following fields:
Field | Type | Description |
Name | Text | Required. The full name for the member |
Email | Text | Required. The email address for the member |
Twitter | Text | The Twitter username for the member |
GitHub | Text | The GitHub username for the member |
LinkedIn | Text | The LinkedIn username for the member |
Discord | Text | The Discord username for the member |
In addition to these fields, you can add as many fields as you want for the questions you want to ask.
For Google Form and Typeform, Orbit uses field labels to map questions to answers.
For the name, use one of the following labels: “Name”, “Your name” or “What is your name?”
For the email, use one of the following labels: “Email”, “Your email”, “Your email address”, “What is your email?” or “What is your email address?”