Support users in selecting 3rd party authentications, either through an existing authentication or by adding new.
/authentications endpoint
:
/authentications
endpoint will return an empty list under the data
key. In this scenario, we should direct the user to the url provided by the /apps
endpoint under the links.connect_new_authentication
key to add a new Authentication.
This is also the best approach to take if you want to offer the user the option to use a new Authentication with this Action, even if they already have Authentications available. (e.g. If the user wants to use a different SuperExampleCRM account than the ones already linked to Zapier)
links.connect_new_authentication
is null
, then this app doesn’t require authentication, and null
should be passed instead of a valid id. Read more about that below.links.connect_new_authentication
link is as follows:
Open the `links.connect_new_authentication` link in a popup
Create an event listener to listen for `zapier.popup.close` messages from that popup
From the message, retrieve the new `authentication_id`
authentication_id
to continue the workflow.null
should be passed in place of a valid authentication id;