Docusign

Capability: eSIGN

Market: US

Business Capabilities

Send an envelope containing one or more documents to recipients, then retrieve an embeddable signing URL.

Exposed Endpoints

• Start OAuth flow: POST /api/docusign/v1/authorize/session
• Create envelope: POST /api/docusign/v1/accounts/{accountId}/envelopes
• Fetch embeddable signing URL: POST /api/docusign/v1/accounts/{accountId}/envelopes/{envelopeId}/views/recipient

Vault Configuration

• baseUrl - Base URL of the Docusign API.
• authUrl - Auth URL of the Docusign API.
• integrationKey - Integration key for obtaining an access token.
• secret - Secret for obtaining an access token.

Obtaining an Access Token

Send a user access token with every request in the X-Docusign-Token header. Obtain the token client-side by performing the OAuth flow through /docusign/v1/authorize/session. Store the access_token securely on the client, because Data Core does not manage user tokens.

Request Structures and Samples

POST /api/docusign/v1/accounts/{accountId}/envelopes

{
    "emailSubject": "Signature Needed",
    "documents": [
        {
            "documentBase64": "base64FileContent",
            "name": "test.pdf",
            "documentId": "1"
        }
    ],
    "recipients": {
        "signers": [
            {
                "email": "first.last@mail.com",
                "name": "First Last",
                "recipientId": "1",
                "routingOrder": "1",
                "clientUserId": "12345"
            }
        ]
    },
    "status": "sent"
}

POST /api/docusign/v1/accounts/{accountId}/envelopes/{envelopeId}/views/recipient

{
    "email": "first.last@mail.com",
    "userName": "First Last",
    "authenticationMethod": "none",
    "clientUserId": "12345",
    "returnUrl": "yourReturnUrl"
}

Error Codes

400 Bad Request - Validation error (e.g., required fields missing).