Create Submission Request

Overview

Create submission request links that allow users to submit data matching your API’s schema. These links can be shared to collect data from various sources.

Creating a Submission Request

Step 1: Access Create Request

1. Under Requests, click Create Request

Step 2: Configure Your Request

Fill out the file request form with the following details:

Form Fields

• API Selection: Choose the API endpoint for this request
• API Schema: Review the column names and data types
• Request Name: Enter a descriptive name for the file request link (required)
• Description: Provide details about what data you’re collecting
• Allow anonymous submissions:
  • ✅ Checked: Users can submit without logging in
  • ❌ Unchecked: Users must be logged in to submit

Step 3: Request Created

After creating your request, you’ll see the request details page with options to:

Edit File Request

Click Edit File Request to:

• Add webhook integrations for real-time notifications
• Configure destination actions for data output
• Modify request settings

For more details, see:

• Webhooks - Set up webhook notifications
• Destinations - Configure data output destinations

Copy Invitation

Click Copy Invitation to:

• Generate a shareable link for data submission
• Share the invitation via instant messaging or email
• Allow users to submit data directly through the link

Best Practices

Request Naming

• Use descriptive names that clearly indicate the data being collected
• Include date or version information for ongoing requests
• Keep names concise but informative

Anonymous vs Authenticated Submissions

• Anonymous: Use for public data collection, surveys, or external submissions
• Authenticated: Use for internal data collection or when you need to track specific users

Data Validation

• Review the API schema before creating requests
• Ensure your data collection matches the expected column structure
• Test requests with sample data before sharing widely