You'll need to send your Access Token along with every API call. Your Access Token is found in your Submittable account on the Settings page (More > Account).
The API uses Basic Authentication. Your Access Token should be sent as the password portion of the Basic Authentication header.
10 transactions per second
10000 transactions per hour
Glossary of Tools and Terms
Users make Submissions to organizations that use the Submittable platform.
Organizations administrate received Submissions from the organization account view.
Submitters have a personal account where they can see and track all Submissions they’ve made.
Organizations can view and track all received Submissions through their organization account view.
Submissions in bulk are seen and organized in an organization’s Submission List view.
Individual Submissions are reviewed in the Submission Details view.
Forms are created using Submittable’s Form Builder.
After Forms are created, they're placed into Projects under the General Settings tab.
Project Titles, when Live, are seen publicly by Submitters on an organization’s landing page.
Projects need a Title and an Initial Form in order to be Live.
Organizations may have many Live Projects active at the same time.
Unique number string tied to each Project.
Funds are a paid-for feature and are not included in every account.
Funds provide a way for Organizations to organize and track existing budgets.
Funds are not connected to any actual Banking system, but are used to determine real distributions.
Review Forms are created for administering reviews/judging of Submissions.
Assigned reviewers complete Review Forms for Submissions to which they are Assigned.
Labels are used to organize Submissions.
Labels can be applied manually post-submission, or by using the Auto-Label feature.
Levels 1-5 Team Members can apply labels to a Submission.
Labels are shown in both the Submissions List view and the Submission Details view.
Label ID: The unique number string attached to each Label.
Each Label has a unique ID. However, label ID’s are not visible within the platform. They are, however, visible to anyone making API calls involving label ID’s
Form Related Calls
Team Member / Reviewer
Organizations have varying numbers of Team Members depending on their account details.
Team Members complete Reviews on behalf of Organizations to which they belong
Organization administrators can give Submission Assignments to any level of Team Member.
Team Member ID: The unique number string tied to each Team Member.
Each Team Member has a unique ID. However, Team Member ID’s are not visible within the platform. They are visible to anyone making API calls that involve Team Member ID’s.
Multi-Stage Review is a paid feature that enables organizations to conduct multiple review rounds for a single Project.
Direct Links to Swagger Documentation for API calls
The hyperlinks below connect directly to our v3 API Swagger Documentation for the specific indicated call:
Form Related Calls
A form request is a request to have an applicant/user complete a Form.
a response is an answer to a form field within a form