Link copied to clipboard!
Mobile navigation button - closed state

Set a custom redirect link

Cord can send a Slack or email notification whenever a user is mentioned or when a thread is shared. By default, this notification contains a link to the page where the conversation happened. You have the option to redirect users to a custom URL instead.


1

Login to the Cord Console, click on your application, then click the Notifications tab.

Paste your URL into the “Redirect URI” field.

2

Understand the payload you will receive

Notifications will contain this link, with an added query parameter cord_notifications that has information about the notification. The parameter’s value will be a JWT, signed with your app’s secret, so that you know the redirect is coming from us.

You can see examples of the payload content for each notification type in the following steps.

3

Verify the JWT

Always start by verifying the cord_notification JWT. See our authentication guide for more detail.

4

Handle requests

For new users, your redirect URI can serve a sign-up flow that is personalized using the data from the cord_notifications payload.

For existing users, your redirect URI can simply redirect the user to the conversation. The URL of the conversation is always part of the cord_notifications payload as shown in the examples below.

5

Example | Mention notification via email

Alice mentions Bob and Bob clicks on the link in his email notification. Bob is taken to <redirect_uri>?cord_notifications={data} where data is a JWT with the following payload:

6

Example | Mention notification via Slack

Alice mentions Bob and Bob clicks on the link in his Slack notification. Bob is taken to <redirect_uri>?cord_notifications={data} where data is a JWT with the following payload. Because Bob might not be a user of your product yet, we provide Bob’s Slack user ID and Slack organization ID.

7

Example | Thread shared to a Slack channel

Alice shares a Cord thread to a Slack channel. The URL of the thread in Slack will take users to <redirect_uri>?cord_notifications={data} where data is a JWT with the following payload:

8

Example | Thread shared to an email

Alice shares a Cord thread to bob@mail.com. The URL in Bob’s email will take Bob to <redirect_uri>?cord_notifications={data} where data is a JWT with the following payload:

Ready!

With your redirect URI configured in the Cord console, and your server ready to handle requests, you’re all done.


Learn more