Get SAML Redirect Url

POST

Gets a SAML initiation URL to redirect your users to.

Request

This endpoint expects an object.

samlConnectionIdstringOptional

The SAML connection to start a SAML login for.

One of samlConnectionId, organizationId, or organizationExternalId must be specified.

organizationIdstringOptional

The ID of the organization to start a SAML login for.

The primary SAML connection in this organization will be used for logins.

One of samlConnectionId, organizationId, or organizationExternalId must be specified.

organizationExternalIdstringOptional

The externalId of the organization to start a SAML login for.

The primary SAML connection in this organization will be used for logins.

One of samlConnectionId, organizationId, or organizationExternalId must be specified.

statestringOptional

This string will be returned back to you when you redeem this login’s SAML access code.

You can do anything you like with this state, but the most common use-case is to keep track of where to redirect your user back to after logging in with SAML.

Response

redirectUrlstringOptional

Redirect your user to this URL to start a SAML login.

Built with

1	curl -X POST https://api.ssoready.com/v1/saml/redirect \
2	-H "Authorization: Bearer <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"organizationExternalId": "my_custom_external_id"
6	}'