Fast Track API

Fast Track is a OneSpan Sign feature that distributes documents for signature through a reusable link instead of creating a new transaction each merge. Author a template once; Fast Track generates a link (or QR code) you can email, embed, or bookmark for repeated use.

The Conga Sign Fast Track API wraps this feature so you need only provide the template and the signer details.

Fast Track produces two link types. Sign selects the correct one automatically based on the template's signer placeholder count.


	Signing URL	Sending URL
Used when	Template has exactly 1 signer placeholder	Template has 2 or more signer placeholders
Who opens it	The signer	A sender, who then distributes to signers
What they enter	Their first name, last name, and email	First name, last name, and email for each signer (Signer 1, Signer 2, …)
Result	Signer goes directly into the signing experience	Sender submits details; invitations are sent to all participants

Why two types? OneSpan hides the Signing URL for templates with multiple placeholders because someone must map people to roles (e.g., buyer vs. seller). That person is the sender, via the Sending URL.

Important: If a single signer already has a OneSpan Sign account, the account name overrides the name entered on the Fast Track link.

Prerequisites

These configuration requirements (not code) must be met for the API to succeed:

An administrator must enable Fast Track on the OneSpan account.
A template must exist for the Fast Track transaction.
The template must include at least one placeholder recipient and a document with a signature field bound to that placeholder.
The template's language must be supported. If the account limits languages, Fast Track URLs cannot be generated for unsupported templates.
The template name appears to signers on the Fast Track links. We recommend you name it clearly.

Glossary


Term	Meaning
Template	A reusable OneSpan package (documents + placeholder roles) used for Fast Track.
Placeholder	An unassigned signer role on the template, filled with real signer details at runtime.
Signing URL	Link for single-signer templates; the signer enters their details and signs.
Sending URL	Link for multi-signer templates; a sender specifies each signer's details before distribution.
Token	Security token embedded in the Fast Track URL, used to create the transaction.

API References

Endpoint

POST /v1/cs-fast-track/{templateId}


Property	Value
Controller	FastTrackController.CreateFastTrackTransaction
Consumes	application/json
Produces	application/json
Auth	Bearer (platform auth via CommonPolicyBaseController)

Path Parameter


Name	Type	Description
templateId	string	The OneSpan template id containing at least one placeholder.

Request Body

A JSON array of roles (placeholders) and their assigned signers. At least one role is required.

With One Placeholder

[
  {
    "id": "PlaceholderId1",
    "name": "PlaceholderId1",
    "signers": [
      {
        "id": "PlaceholderId1",
        "email": "[email protected]",
        "firstName": "Sign",
        "lastName": "DevOne"
      }
    ]
  }
]

With Multiple Placeholders

[
  {
    "id": "PlaceholderId1",
    "name": "PlaceholderId1",
    "signers": [
      {
        "id": "PlaceholderId1",
        "email": "[email protected]",
        "firstName": "Sign",
        "lastName": "DevOne"
      }
    ]
  },
  {
    "id": "PlaceholderId2",
    "name": "PlaceholderId2",
    "signers": [
      {
        "id": "PlaceholderId2",
        "email": "[email protected]",
        "firstName": "Sign",
        "lastName": "DevTwo"
      }
    ]
  }
]

Field Definitions


Object	Field	Required	Notes
FastTrackRole	id	Yes	The placeholder id defined on the template. Must match the template exactly.
FastTrackRole	name	No	The placeholder name.
FastTrackRole	signers	Yes (min 1)	The signer(s) assigned to this placeholder.
FastTrackSigner	id	Yes	Signer id (typically matches the placeholder id).
FastTrackSigner	email	Yes	Valid email address.
FastTrackSigner	firstName	No	Signer first name.
FastTrackSigner	lastName	No	Signer last name.

Note: This API has no signing query parameter. The Signing vs Sending decision is derived from the template's placeholder count

Responses


Code	Meaning
200 OK	Transaction created. Returns the OneSpan Fast Track response.
400 Validation Error	Invalid input, or template not Fast Track–eligible (e.g., no placeholder).
401 Not Authorized	Missing or expired auth.
404 Not Found	Template not found.
500 Unexpected Error	Unhandled server error.


Outcome	Result
0 placeholders	Fails fast with a clear validation message.
1 placeholder	Signing URL (signing=true).
2+ placeholders	Sending URL (signing=false).


Purpose	Endpoint
Read template & placeholders	`GET /api/packages/{templateId}`

Error Scenarios and Meaning


Scenario	Result	Reason
Template has no placeholder	400 - clear validation message	Fast Track requires ≥ 1 placeholder with a signature field
id doesn't match a template placeholder	400 from OneSpan	Placeholder can't be mapped
Body sent as { "roles": [...] }	400 Invalid JSON	OneSpan expects a bare array
Fast Track not enabled on account	Error from OneSpan	Admin must enable Fast Track
Unsupported template language	Error from OneSpan	Language limited on account

Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Fast Track API

Prerequisites

API References

Request Body

Responses

Footer Section

Explore