{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/web-uis/redirect-overview/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Redirect Integration (Legacy)

\n

This style of integration involves sending the user to the Tilia flow via a full page navigation from your domain to Tilia’s.

\n

The diagram below illustrates the flow of information within a redirect integration.

\n

\n ' \\\\\n--header 'Content-Type: application/json' \\\\`, `92730239207280840000`)\"\n >\n

Copy
\n
Copied
\n \n 
curl --location --request POST https://auth.tilia-inc.com/authorize/user \\\n--header 'Authorization: Bearer <Access_Token>' \\\n--header 'Content-Type: application/json' \\
\n \n

Request body

\n
\n
"\n}`, `65652112555992950000`)\"\n >\n
Copy
\n
Copied
\n
\n 
{\n\t\"account_id\": \"<tilia_account_id>\"\n}
\n
\n

Sample response

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n    \"status\": \"Success\",\n    \"message\": [],\n    \"codes\": [],\n    \"payload\": {\n        \"redirect\": \"https://web.tilia-inc.com/ui/appauth/ed8ff1e9-9256-4205-918a-b9ca23ec00ec\"\n    }\n}
\n
\n

The response includes a redirect URL which is used in the next step.

\n
The nonce is valid for 24 hours. We recommend generating a nonce immediately before sending the user to a Tilia UI.
\n

Step 2: Create the flow link

\n

Next, you will create a link for the user to access the flow.

\n
\n
?flow=&returnurl=”>Click here to start the flow"`, `82964183397650240000`)\"\n >\n
Copy
\n
Copied
\n
\n 
<a href=”<redirect.url>?flow=<flow.name>&returnurl=<your.return.url?your.parameters>”>Click here to start the flow</a>\"
\n
\n

Where:

\n\n

Step 3: Handle the flow result

\n

Upon completing the flow, the user is redirected to <your.return.url>, with flow-specific parameters appended.

\n
\n
&`, `47858869411808570000`)\"\n >\n
Copy
\n
Copied
\n
\n 
<your.return.url?your.parameters>&<tilia.flow.parameters>
\n
\n

Refer to the flow-specific documentation for details on the parameters returned.

","headings":[{"value":"Redirect Integration (Legacy)","depth":1},{"value":"To integrate using the redirect method","depth":2},{"value":"Step 1: User authorization","depth":3},{"value":"Request body","depth":4},{"value":"Sample response","depth":4},{"value":"Step 2: Create the flow link","depth":3},{"value":"Step 3: Handle the flow result","depth":3}]},"contentItem":{"data":{"lastModified":"2023-06-27T21:19:02.000Z","enableToc":false,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":2}},"pageContext":{"matchPath":"","id":"4503977e-0acf-5a7f-a713-379fce3a5016__redocly content/web-uis/redirect-overview/","seo":{"title":"Redirect Integration (Legacy)","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"web-uis/redirect-overview.md","pageBaseUrl":"/web-uis/redirect-overview","type":"markdown","toc":{"enable":false,"maxDepth":2,"headings":[{"depth":1,"value":"Redirect Integration (Legacy)","id":"redirect-integration-legacy"},{"depth":2,"value":"To integrate using the redirect method","id":"to-integrate-using-the-redirect-method"},{"depth":3,"value":"Step 1: User authorization","id":"step-1-user-authorization"},{"depth":4,"value":"Request body","id":"request-body"},{"depth":4,"value":"Sample response","id":"sample-response"},{"depth":3,"value":"Step 2: Create the flow link","id":"step-2-create-the-flow-link"},{"depth":3,"value":"Step 3: Handle the flow result","id":"step-3-handle-the-flow-result"}]},"data":{"title":"","enableToc":false},"catalogInfo":null,"link":"/web-uis/redirect-overview/","sidebarName":"","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}