Next, you will be ask to provide information about your integration:
Name: Add the name of your integration.
Description: Add a description the app in 140 characters or less.
Homepage URL: Add the homepage URL of your app. The domain will be used as the email domain to allow team members to join your integration as a collaborator.
Logo: Upload a square, transparent PNG image of your app logo. The image must be at least 256x256px in size, and doesn’t include the app name. Learn more in branding guidelines.
Authentication defines how Zapier’s platform authenticates with the app’s API you’re connecting to, collecting and storing user data to allow access to their accounts. Zapier supports the following authentication schemes:
Refer to the API documentation for the app you’re building with to choose the correct authentication scheme for your API. Add the authentication fields for the input form your users will see when connecting their app account to Zapier.Move through each configuration step of your chosen authentication scheme, adding the relevant endpoint to be used as the authorization URL to exchange the credentials supplied by the user for authentication. Depending on your API’s authentication method, you may also need to configure Zapier-provided application credentials in your app’s developer settings.
Triggers allow users to start Zapier workflows when something is added or updated in the app.Add settings for how your trigger displays to users, any optional input fields, and connect the app’s API in the API Configuration tab.If the API you’re building with supports REST Hooks, you can configure your trigger to create a unique subscription from every Zap to your app that will run in near real-time and send events to Zapier as they occur in your app.Alternatively, configure a polling trigger that automatically polls the URL you’ve provided for new data every 1 to 15 minutes, depending on the user’s Zapier plan. An appropriate polling endpoint will return results in reverse chronological order to make sure new or updated items can be found on the first page of the results. Polling an endpoint most commonly uses a GET request.The default Form Mode allows you to add API endpoint URLs, choose the API call type, and include any authentication details and input form data with the API call.The optional toggle into Code Mode converts everything entered in the API request form to JavaScript code and is an advanced feature beyond the scope of this tutorial.
Actions allow users to create, search, or update records in your app through your API. In general, delete actions are not recommended for integrations.Add settings for how your action displays to users, and at least one input field and connect the app’s API in the API Configuration tab.Refer to the API documentation for your app to choose a frequently used record with an available endpoint and add a create action that will add an record in your app when tested. Creating a new record most commonly uses a POST request.
When building an integration, it’s important to test the functionality of your authentication, triggers, and actions in the Platform UI and also in the Zap editor. In the Zap editor, you’ll see how users of your integration will create Zaps using your triggers, and actions.Learn more about testing your integration.
Run automated checks to identify errors and recommendations on how to improve the user experience of your integration.These checks are only required to pass if you are building a public integration, but they are also useful to identify suggestions for future updates to any integration.
Integrations are not owned by individuals, but rather by teams. You can invite team members to collaborate with in the Platform UI as either an admin or a collaborator.Learn more about adding team members to your integration.
Once you have at least one trigger or action, you’ll want to share your integration with some users. Early feedback helps make sure you’re building functionality that will be used.You can share your integration with users by a public link or by email.Note: Public integrations can be accessed by any Zapier user and doesn’t require users to be specially invited.
If you need to make any changes to your integrations, you can do so by creating a new version. Versions helps to track and manage changes to your integration over time.Public integrations or private integrations with more than 5 users must have a new version to make any edits. It is still recommended to make changes for private integrations with fewer than 5 users in a new version as well and consider Zapier’s best practices when doing so.