Setting up authentication for your app
Create purchase
or Bulk...
endpoints - require OAuth authentication, so will not be able to be tested this way. Specific authentication requirements can be found for each endpoint in the API documentation.Creator installs your app
Kit App Store
Example app details page
k_app_id=k_{app_id}
(which allows us to attribute sign-ups to your particular app). To find your app id - click the “Preview” button for the app on the Bulid tab of the Kit App Store and the id will be found in the URL path app.kit.com/apps/{app_id}
.
For example, for the GIPHY app, you would send your users to https://app.kit.com/apps/717?k_app_id=k_717
Redirect to plugin authorization flow
Example 3rd party hosted OAuth page
API authentication
redirect
property that is appended to the GET request, as this will be the URL your app will need to redirect to once the Oauth flow is completedExample 3rd party hosted OAuth page
Redirect the user to complete the installation
redirect
, URL provided as a query paramter in the initial authorization request. This will ensure the installation flow is tracked and completed properly. This property currently sends users back to your app’s details page, which will help guide them through using and getting the most out of your app they have just added to their creator kit.
Redirect URL after install
field in your app’s settings, a modal prompting creators to continue their journey on your configured site will appear at this point. See this section in the app details page guide for more details.Example redirect flow
Ongoing refresh token flow
https://app.kit.com/apps/:app_id/install
replacing :app_id
with your specific app ID.
For proper attribution of new signups from your app, append the k_app_id=k_:app_id
query parameter to all instances of the install URL:
https://app.kit.com/apps/:app_id/install?k_app_id=k_:app_id
This helps us track installations that originate from your app and attribute any new Kit signups accordingly.
https://app.kit.com/apps/924/edit
means your app ID is 924
)https://app.kit.com/apps/924
)