Follow this guide to authenticate your Scrive account in Journeys.
Before starting...
Make sure you have a Scrive account with Scrive API access.
Make sure you are an admin in Scrive.
Ask the 50skills team to copy the Scrive integration template to your Journeys account if we have not done so already.
Useful links and documentation
Scrive eSign API guide: https://helpcenter.scrive.com/kb/guide/en/get-started-with-the-esign-api-1uv37xAMwh/Steps/1804485
Scrive API docs: https://apidocs.scrive.com
Base URL: https://scrive.com/api/v2/
1. Create an integration user in Scrive
Instead of tying authentication to one specific employee within your company, we recommend creating a separate integration user in Scrive using a shared company email address (such as hr@yourcompany.com). Make sure you have access to that email's inbox.
When you have decided on an email address, please follow these steps:
Log into your Scrive admin account
In the left sidebar, go to Account > Users and Groups
Create a new user with your shared company email address and grant the user the Standard User role.
Go to the shared email's inbox, accept the Scrive invite, and set up a login password. You will need your chosen password for the next step in this guide.
2. Generate Personal access credentials
You can do this either via Scrive, or via the /getpersonaltoken endpoint in Journeys.
Via Scrive
Log into Scrive as the integration user
Go to Integrations -> Integration settings
Scroll down to the Personal access credentials section and click Create.
Copy-paste the following four fields somewhere safe for later:
Client credentials identifier =
{YOUR_API_TOKEN}Client credentials secret =
{YOUR_API_SECRET}Token credentials identifier =
{YOUR_ACCESS_TOKEN}Token credentials secret =
{YOUR_ACCESS_SECRET}
Via /getpersonaltoken in Journeys
The Scrive integration template in Journeys should have an endpoint called "SETUP: Get personal token".
Click the right collapse arrow on that endpoint and click Test.
Input the integration user's email and password, then click test.
The response should look like this:
{
"apitoken": "{YOUR_API_TOKEN}",
"apisecret": "{YOUR_API_SECRET}",
"accesstoken": "{YOUR_ACCESS_TOKEN}",
"accesssecret": "{YOUR_ACCESS_SECRET}"
}Click the clipboard icon (inside the red box) to copy the content. Paste it somewhere safe to use later.
3. Authenticate in Journeys
Now you should have your integration user's API token, API secret, access token, and access secret ready.
In Journeys, click Authenticate in the Scrive integration template.
Fill in the fields as follows:
Authentication type: Authorization header
Prefix: leave empty
Token (scroll right to see entire text ->):
oauth_signature_method="PLAINTEXT",oauth_consumer_key="{YOUR_API_TOKEN}",oauth_token="{YOUR_ACCESS_TOKEN}",oauth_signature="{YOUR_API_SECRET}&{YOUR_ACCESS_SECRET}"💡Note: Replace
{YOUR_API_TOKEN},{YOUR_ACCESS_TOKEN},{YOUR_API_SECRET}, and{YOUR_ACCESS_SECRET}with your credentials from step 2.
Now save the authentication and test a GET endpoint (green icon) to make sure it's authenticated.
If the test returns 200 success, you are done! 🎉