Compartilhar via


BlueInk

The Blueink connector allows you to add Blueink's eSignature platform into automated workflows. The connector allows you to check bundle status, create new bundles, access signer information, and more.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Blueink Support
URL https://help.blueink.com/en/
Email support@blueink.com
Connector Metadata
Publisher Blueink
Website https://blueink.com
Privacy policy https://blueink.com/privacy-policy/
Categories Business Management;Productivity

With this versatile connector, users can seamlessly integrate Blueink's powerful eSignature solution into their workflow by leveraging the capabilities of various Power Automate connectors. This integration empowers users to automate the creation and distribution of document bundles effortlessly. By orchestrating the harmonious interaction of this connector with other connectors, you can streamline your document management processes, enhance efficiency, and ensure a seamless and efficient document signing experience for your clients and stakeholders. Whether it's automating contract approvals, processing legal documents, or managing paperwork in any other context, this connector provides a powerful tool to optimize your workflow and boost productivity.

Prerequisites

To use this connector you will need an API enabled account from blueink.com.

How to get credentials

After creating your account, click the API button on the left side of the page. Under Private API Keys, press the Add API Key button. Give the API key a label and press submit. Copy the API key and save it somewhere, because it won’t be shown again.

Get started with your connector

When first creating a Blueink connection you will be prompted to enter an API key. Your API key will always need to start with Token followed by a space and then the API key you created. Inputting your API key should look like this Token .

A popular action is to create a bundle. Creating a bundle does require a complex set of inputs. Take a look at our API documentation at https://blueink.com/esignature-api/api-docs/#tag/Bundles/operation/createBundle for what the body variable could look like. Picture below as an example of a bundle creation body.

Untitled

There are multiple ways to create a bundle and you can modify this JSON to suit the bundle you wish to create. Take a look at the API for more ways this JSON can be modified. This one uses a previously created template that the user setup in their account.

Listing all of the completed bundles is another popular endpoint. Add the List Bundles action and then change the status button to co for completed bundles. You can keep up to date with all of your latest completed bundles using this endpoint.

Untitled

Known issues and limitations

A body JSON is required for the bundle creation endpoint

Common errors and remedies

If you get an error about a request not succeeding with an invalid token error make sure you didn’t just paste the API key in and including the preceding Token string followed be a space and then your API key.

If you get an error about an invalid input when creating a Bundle make sure it is valid JSON that is being sent to Blueink.

FAQ

1. What is Blueink?

  • Blueink is an advanced eSignature solution that simplifies the document signing process, making it easy to send, sign, and manage electronic documents securely.

2. What is the Microsoft Connector for Blueink?

  • The Microsoft Connector for Blueink is a tool that allows users to integrate Blueink's eSignature solution seamlessly with Microsoft Power Automate, enabling automation and enhanced document management.

3. How does the Microsoft Connector for Blueink work?

  • The connector enables you to create automated workflows by combining Blueink with other Power Automate connectors. You can automate the creation and distribution of document bundles, enhancing your document management processes.

4. What are some use cases for the Microsoft Connector for Blueink?

  • Common use cases include automating contract approvals, managing legal documents, streamlining paperwork processes, and ensuring a smooth and efficient document signing experience for clients and stakeholders.

5. Can I use the Microsoft Connector for Blueink with other Microsoft products?

  • Yes, the connector is designed to work seamlessly with various Microsoft products and services, allowing you to integrate Blueink eSignatures into your Microsoft-centric workflows.

6. Is the Microsoft Connector for Blueink easy to set up and use?

  • Yes, it is user-friendly and designed to be straightforward. You can configure and customize your workflows to suit your specific document management needs.

7. Is there any cost associated with using the Microsoft Connector for Blueink?

  • Pricing may vary based on your usage and licensing agreements. It's best to check with Blueink or Microsoft for specific pricing details.

8. Can I get support for any technical issues with the Microsoft Connector for Blueink?

  • Yes, Blueink and Microsoft typically offer support resources and documentation to assist with any technical issues or questions you may have regarding the connector's usage.

9. Is the Microsoft Connector for Blueink compatible with both Windows and cloud-based Microsoft services?

  • Yes, the connector is designed to work with both on-premises and cloud-based Microsoft services, providing flexibility in your integration options.

10. Where can I find more information about the Microsoft Connector for Blueink?

  • For additional information, including setup guides and documentation, you can visit the Blueink website or explore the Microsoft Power Automate documentation related to this connector.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Blueink API Key securestring Your Blueink API key. This can be created in Blueink under the API tab. Correct format is 'Token XXXXXX' where XXXXXX is your API key True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Add Tags to a bundle

Add additional tags to a Bundle. No existing tags on the Bundle are removed. The result of this call is that Bundle.tags is the union of the set of previous tags with the set of new tags. Duplicate tags are ignored.

Cancel a Bundle

Cancel the Bundle specified by the Bundle Slug

Create a Bundle

Create and send a bundle out for signature

Create a Person

Create a new person. A person can be associated with a BlueInk User, or can be a standalone person. If you want to create a person that is associated with a BlueInk User, you must provide the user_id field. If you want to create a standalone person, you must provide the name field.

Create a Webhook

Create a new Webhook

Create a WebhookExtraHeader

Create a new Webhook Header

Create an Embedded Signing URL

Create a URL which can be used for embedded signing

Delete a Person

Delete a Person. This will also delete any associated BlueInk User.

Delete a Webhook

Delete a Webhook by ID

Delete a WebhookExtraHeader

Delete a WebhookExtraHeader

Get Webhook Shared Secret

Get the Webhook Shared Secret

List Bundle Events

Get a list of Events that are associated with the Bundle

List Bundles

Returns a paginated list of Bundles in your Account, ordered by created date (from most recent to least recent). Pagination can be controlled via Pagination paramaters (see Overview->Pagination). Querystring filters paramaters can be combined, e.g. /bundles/?search=Gibbons&status__in=se,co&tag=needs-attention. When combining filters, only Bundles matching ALL the filters are returned.

List Document Templates

List all Document Templates

List Persons

Get a list of the Persons in your account. You can optionally filter the list by providing a search query. For example, to search for all Persons with the name "John", you would use the query search=John.

List WebhookEvents

List all Webhook Events in your BlueInk account

List WebhookEvents

List all WebhookDeliveries in your BlueInk account

List WebhookExtraHeaders

List all WebhookExtraHeaders in your BlueInk account

List Webhooks

List all Webhooks in your BlueInk account

Partially update a Person

Partially update the Person with new data.

To add a new email or phone to the Person, include a ContactChannel in the 'channels' array without an 'id'.

To update an existing ContactChannel associated with the Person, include an 'id'. That existing ContactChannel will be updated with the new email or phone. This will update any live Bundles associated with the Person that are sending to that email (or phone).

If a ContactChannel does not include an 'id', but the email (or phone) matches an existing ContactChannel, then that ContactChannel will not be changed.

Partially update a Webhook

Partially update the Webhook with new data.

Partially update a WebhookExtraHeader

Partially update the WebhookExtraHeader with new data.

Regenerate Webhook Shared Secret

Regenerate the Webhook Shared Secret

Remove Tags from a bundle

Remove tags from a Bundle. If a tag in the request does not exist on the Bundle, it is ignored.

Retrieve a Bundle

Retrieve a Bundle by slug

Retrieve a Document Template

Retrieve a Document Template

Retrieve a Person

Get a Person by ID

Retrieve a Webhook

Get a Webhook by ID

Retrieve a WebhookExtraHeader

Retrieve the details of a WebhookExtraHeader

Retrieve Bundle Data

Get data entered into fields for a completed Bundle

Retrieve Bundle Files

Get downloadable files for a completed Bundle

Retrieve Packet Certificate of Evidence

Get a link and checksum of the Certificate of Evidence for this Packet

Send a Reminder

Send a Reminder email or SMS to a Signer. A reminder can only be sent once every hour. The reminder will be sent via the delivery method (email or SMS) and to the email address (or phone number) previously designated for this Packet.

Update a Packet

Update a Packet (aka signer) with a new email, phone number, name or authentication options

The updated packet must still be deliverable. For instance, if you specify a deliver_via value of 'phone', but there was no phone number set in the original PacketRequest, then this request must include a phone as well, or an error will be returned.

You can change a Packet that was originally configured for embedded signing (that is, deliver_via was 'embed') to be delivered via email or SMS. However, no signing notifications or reminders will be automatically sent. You must call /packet/{packetId}/remind/ to send a signing notification email (or SMS).

If this Signer is associated with a Person, the person will be updated as well - the Person name will be changed (if provided) and any new email or phone number will be added.

Update a Person

Update the Person with new data. NOTE that any contact channels that are omitted from this request will be DELETED. If you don't want to replace all data on the Person, you probably want to use PATCH instead.

Update a Webhook

Update the Webhook with new data. NOTE that any subscriptions that are omitted from this request will be DELETED. If you don't want to replace all data on the Webhook, you probably want to use PATCH instead.

Update a WebhookExtraHeader

Update the WebhookExtraHeader with new data

Add Tags to a bundle

Add additional tags to a Bundle. No existing tags on the Bundle are removed. The result of this call is that Bundle.tags is the union of the set of previous tags with the set of new tags. Duplicate tags are ignored.

Parameters

Name Key Required Type Description
Bundle Slug
bundleSlug True string

The slug that uniquely identifies the Bundle

tags
tags array of string

An array of tags

Returns

Cancel a Bundle

Cancel the Bundle specified by the Bundle Slug

Parameters

Name Key Required Type Description
Bundle Slug
bundleSlug True string

The slug that uniquely identifies the Bundle

Returns

Create a Bundle

Create and send a bundle out for signature

Parameters

Name Key Required Type Description
body
body

The JSON body that defines the Bundle to be created

Returns

Create a Person

Create a new person. A person can be associated with a BlueInk User, or can be a standalone person. If you want to create a person that is associated with a BlueInk User, you must provide the user_id field. If you want to create a standalone person, you must provide the name field.

Parameters

Name Key Required Type Description
email
email email
id
id uuid
kind
kind string

em for email. mp for phone.

phone
phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

Returns

Name Path Type Description
channels
channels array of object
email
channels.email email
id
channels.id uuid
kind
channels.kind string

em for email. mp for phone.

phone
channels.phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

Create a Webhook

Create a new Webhook

Parameters

Name Key Required Type Description
enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Returns

Name Path Type Description
enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

extra_headers
extra_headers array of object
id
extra_headers.id uuid
name
extra_headers.name string

must adhere to RFC 7230

order
extra_headers.order integer
value
extra_headers.value string

must adhere to RFC 7230

webhook
extra_headers.webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Create a WebhookExtraHeader

Create a new Webhook Header

Parameters

Name Key Required Type Description
id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid

Returns

Name Path Type Description
id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid

Create an Embedded Signing URL

Create a URL which can be used for embedded signing

Parameters

Name Key Required Type Description
Packet Slug
packetId True string

The slug that uniquely identifies the Packet

Returns

Name Path Type Description
expires
expires date-time

Timestamp indicating when url expires

url
url string

The URL which can be used in for embedded signing

Delete a Person

Delete a Person. This will also delete any associated BlueInk User.

Parameters

Name Key Required Type Description
Person ID
personId True uuid

The ID that uniquely identifies the Person

Delete a Webhook

Delete a Webhook by ID

Parameters

Name Key Required Type Description
Webhook ID
webhookId True uuid

The ID that uniquely identifies the Webhook

Delete a WebhookExtraHeader

Delete a WebhookExtraHeader

Parameters

Name Key Required Type Description
WebhookExtraHeader ID
webhookExtraHeaderId True uuid

The ID that uniquely identifies the WebhookExtraHeader

Get Webhook Shared Secret

Get the Webhook Shared Secret

Returns

Name Path Type Description
create_date
create_date date-time
secret
secret b58

List Bundle Events

Get a list of Events that are associated with the Bundle

Parameters

Name Key Required Type Description
Bundle Slug
bundleSlug True string

The slug that uniquely identifies the Bundle

Returns

Name Path Type Description
array of object
description
description string

A brief desription of the event

kind
kind string

The kind of the event as a 2 character code

packet_id
packet_id uuid

The UUID of a Packet. Only present if the event is associated with a particular packet.

timestamp
timestamp date-time

The time at which the event occured

List Bundles

Returns a paginated list of Bundles in your Account, ordered by created date (from most recent to least recent). Pagination can be controlled via Pagination paramaters (see Overview->Pagination). Querystring filters paramaters can be combined, e.g. /bundles/?search=Gibbons&status__in=se,co&tag=needs-attention. When combining filters, only Bundles matching ALL the filters are returned.

Parameters

Name Key Required Type Description
Search Query
search string

A search query. Only bundles matching the search will be returned. The following data in the the Bundle is searched:

  • bundle slug
  • bundle label
  • bundle custom_key
  • signer name
  • signer email
  • signer phones

E.g. /bundles/?search=foobar@example.com

Bundle Status
status string

Limit bundles to those with the specified status.

  • dr: Draft - the Bundle has not yet been sent
  • se: Sent - the Bundle has been sent, but not yet started by any Signers
  • st: Started - at least one Signer has started reviewing the document(s)
  • co: Complete - all Signers have completed reviewing / signing
  • ca: Cancelled - the Bundle was cancelled
  • ex: Expired - the Bundle expired before it was Complete
  • fa: Failed - an error occurred and the Bundle could not be created or completed

E.g. /bundles/?status=co

List of Bundle Status
status__in string

Limit bundles to those with one of the specified statuses. Statuses should be comma separated. E.g. /bundles/?status=co,se,st

Bundle Tag
tag string

Return Bundles that have the given tag. E.g. /bundles/?tag=some-tag

List of Bundle Tags
tag__in string

Return Bundles that have at least one of the given tags. Tags should be comma separated. E.g. /bundles/?tag=some-tag,another-tag

Bundle Sort Order
ordering string

Control the sort order of Bundles. Prefix with "-" to reverse the sort order. By default Bundles are sorted by "-created", ie the Bundle creation date from most to least recent.

Returns

Name Path Type Description
array of

List Document Templates

List all Document Templates

Returns

Name Path Type Description
fields
fields array of

An array of fields placed on the document. Note that DocumentTemplate fields are slightly different than DocumentRequest fields, having a default_value and editor_roles instead of initial_value and editors.

file_url
file_url string

The URL of the original file that serves as the basis for this Template

is_shared
is_shared boolean

True if the Document Template is shared. False otherwise

name
name string

The name of the document. Defaults to the filename or the document when it was uploaded, but can be set to a human-friendly name.

roles
roles array of object
key
roles.key string

A string that is unique for this document which identifies this role

label
roles.label string

A human-friendly label for this role

List Persons

Get a list of the Persons in your account. You can optionally filter the list by providing a search query. For example, to search for all Persons with the name "John", you would use the query search=John.

Parameters

Name Key Required Type Description
Search Query
search string

A search query.

Returns

Name Path Type Description
array of object
channels
channels array of object
email
channels.email email
id
channels.id uuid
kind
channels.kind string

em for email. mp for phone.

phone
channels.phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

List WebhookEvents

List all Webhook Events in your BlueInk account

Parameters

Name Key Required Type Description
Webhook ID
webhook uuid

Only WebhookEvents matching the selected webhook ID will be returned.

E.g. /webhooks/events/?webhook=a053644f-e371-4883-ac17-534445993346

Event Type
event_type string

Only WebhookEvents with webhooks matching the selected event_type or event_types will be returned.

E.g. /webhooks/events/?event_type=bundle_sent E.g. /webhooks/events/?event_type__in=bundle_error,bundle_cancelled

Status
status integer

Only WebhookEvents matching the selected status will be returned.

E.g. /webhooks/events/?status=1 E.g. /webhooks/events/?status__in=0,1,2

Success Result
success boolean

Only WebhookEvents matching the selected success status will be returned.

E.g. /webhooks/events/?success=true

Date Range
date date-time

Only WebhookEvents occurring between a date range will be returned. Note: Dates are expressed as YYYY-MM-DD format.

E.g. /webhooks/events/?date_after=2022-10-01&date_before=2022-10-31

Returns

Name Path Type Description
array of object
created
created date-time
deliveries
deliveries array of object
message
deliveries.message string

a message describing any issues

pk
deliveries.pk uuid
status
deliveries.status integer

status message of the response, or 0 if no status

timestamp
deliveries.timestamp date-time

when the delivery attempt occurred (the start of the attempt, not when it failed, e.g for a timeout)

event_type
event_type string
payload
payload string

the payload to send on delivery; json

pk
pk uuid
status
status integer

the status code of the last response from webhook endpoint. 0 indicates no response received

success
success boolean
webhook
webhook uuid

UUID identifying which webhook the Event belongs to

List WebhookEvents

List all WebhookDeliveries in your BlueInk account

Parameters

Name Key Required Type Description
Webhook ID
webhook uuid

Only WebhookDeliveries matching the selected webhook ID will be returned.

E.g. /webhooks/deliveries/?webhook=a053644f-e371-4883-ac17-534445993346

Webhook Event ID
webhook_event uuid

Only WebhookDeliveries matching the selected webhook_event ID will be returned.

E.g. /webhooks/deliveries/?webhook_event=a053644f-e371-4883-ac17-534445993346

Event Type
event_type string

Only WebhookDeliveries with webhooks matching the selected event_type or event_types will be returned.

E.g. /webhooks/deliveries/?event_type=bundle_sent E.g. /webhooks/deliveries/?event_type__in=bundle_error,bundle_cancelled

Status
status integer

Only WebhookDeliveries matching the selected status will be returned.

E.g. /webhooks/deliveries/?status=1 E.g. /webhooks/deliveries/?status__in=0,1,2

Date Range
date date-time

Only WebhookDeliveries occurring between a date range will be returned. Note: Dates are expressed as YYYY-MM-DD format.

E.g. /webhooks/deliveries/?date_after=2022-10-01&date_before=2022-10-31

Returns

Name Path Type Description
array of object
created
created date-time
deliveries
deliveries array of object
message
deliveries.message string

a message describing any issues

pk
deliveries.pk uuid
status
deliveries.status integer

status message of the response, or 0 if no status

timestamp
deliveries.timestamp date-time

when the delivery attempt occurred (the start of the attempt, not when it failed, e.g for a timeout)

event_type
event_type string
payload
payload string

the payload to send on delivery; json

pk
pk uuid
status
status integer

the status code of the last response from webhook endpoint. 0 indicates no response received

success
success boolean
webhook
webhook uuid

UUID identifying which webhook the Event belongs to

List WebhookExtraHeaders

List all WebhookExtraHeaders in your BlueInk account

Parameters

Name Key Required Type Description
Webhook ID
webhook uuid

Only WebhookExtraHeaders matching the selected webhook ID will be returned.

E.g. /webhooks/headers/?webhook=a053644f-e371-4883-ac17-534445993346

Event Type
event_type string

Only WebhookExtraHeaders with webhooks matching the selected event_type or event_types will be returned.

E.g. /webhooks/headers/?event_type=bundle_sent E.g. /webhooks/headers/?event_type__in=bundle_error,bundle_cancelled

Returns

Name Path Type Description
array of object
id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid

List Webhooks

List all Webhooks in your BlueInk account

Parameters

Name Key Required Type Description
Enabled
enabled boolean

Only Webhooks matching the selected 'enabled' state will be returned.

E.g. /webhooks/?enabled=true

Event Type
event_type string

Only Webhooks matching the selected event_type or event_types will be returned.

E.g. /webhooks/?event_type=bundle_sent E.g. /webhooks/?event_type__in=bundle_error,bundle_cancelled

Returns

Name Path Type Description
array of object
enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

extra_headers
extra_headers array of object
id
extra_headers.id uuid
name
extra_headers.name string

must adhere to RFC 7230

order
extra_headers.order integer
value
extra_headers.value string

must adhere to RFC 7230

webhook
extra_headers.webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Partially update a Person

Partially update the Person with new data.

To add a new email or phone to the Person, include a ContactChannel in the 'channels' array without an 'id'.

To update an existing ContactChannel associated with the Person, include an 'id'. That existing ContactChannel will be updated with the new email or phone. This will update any live Bundles associated with the Person that are sending to that email (or phone).

If a ContactChannel does not include an 'id', but the email (or phone) matches an existing ContactChannel, then that ContactChannel will not be changed.

Parameters

Name Key Required Type Description
Person ID
personId True uuid

The ID that uniquely identifies the Person

email
email email
id
id uuid
kind
kind string

em for email. mp for phone.

phone
phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

Returns

Name Path Type Description
channels
channels array of object
email
channels.email email
id
channels.id uuid
kind
channels.kind string

em for email. mp for phone.

phone
channels.phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

Partially update a Webhook

Partially update the Webhook with new data.

Parameters

Name Key Required Type Description
Webhook ID
webhookId True uuid

The ID that uniquely identifies the Webhook

enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Returns

Name Path Type Description
enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

extra_headers
extra_headers array of object
id
extra_headers.id uuid
name
extra_headers.name string

must adhere to RFC 7230

order
extra_headers.order integer
value
extra_headers.value string

must adhere to RFC 7230

webhook
extra_headers.webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Partially update a WebhookExtraHeader

Partially update the WebhookExtraHeader with new data.

Parameters

Name Key Required Type Description
WebhookExtraHeader ID
webhookExtraHeaderId True uuid

The ID that uniquely identifies the WebhookExtraHeader

id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid

Returns

Name Path Type Description
id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid

Regenerate Webhook Shared Secret

Regenerate the Webhook Shared Secret

Returns

Name Path Type Description
create_date
create_date date-time
secret
secret b58

Remove Tags from a bundle

Remove tags from a Bundle. If a tag in the request does not exist on the Bundle, it is ignored.

Parameters

Name Key Required Type Description
Bundle Slug
bundleSlug True string

The slug that uniquely identifies the Bundle

tags
tags array of string

An array of tags

Returns

Retrieve a Bundle

Retrieve a Bundle by slug

Parameters

Name Key Required Type Description
Bundle Slug
bundleSlug True string

The slug that uniquely identifies the Bundle

Returns

Retrieve a Document Template

Retrieve a Document Template

Parameters

Name Key Required Type Description
Template ID
templateId True uuid

The ID that uniquely identifies the Template

Returns

Name Path Type Description
fields
fields array of

An array of fields placed on the document. Note that DocumentTemplate fields are slightly different than DocumentRequest fields, having a default_value and editor_roles instead of initial_value and editors.

file_url
file_url string

The URL of the original file that serves as the basis for this Template

is_shared
is_shared boolean

True if the Document Template is shared. False otherwise

name
name string

The name of the document. Defaults to the filename or the document when it was uploaded, but can be set to a human-friendly name.

roles
roles array of object
key
roles.key string

A string that is unique for this document which identifies this role

label
roles.label string

A human-friendly label for this role

Retrieve a Person

Get a Person by ID

Parameters

Name Key Required Type Description
Person ID
personId True uuid

The ID that uniquely identifies the Person

Returns

Name Path Type Description
channels
channels array of object
email
channels.email email
id
channels.id uuid
kind
channels.kind string

em for email. mp for phone.

phone
channels.phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

Retrieve a Webhook

Get a Webhook by ID

Parameters

Name Key Required Type Description
Webhook ID
webhookId True uuid

The ID that uniquely identifies the Webhook

Returns

Name Path Type Description
enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

extra_headers
extra_headers array of object
id
extra_headers.id uuid
name
extra_headers.name string

must adhere to RFC 7230

order
extra_headers.order integer
value
extra_headers.value string

must adhere to RFC 7230

webhook
extra_headers.webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Retrieve a WebhookExtraHeader

Retrieve the details of a WebhookExtraHeader

Parameters

Name Key Required Type Description
WebhookExtraHeader ID
webhookExtraHeaderId True uuid

The ID that uniquely identifies the WebhookExtraHeader

Returns

Name Path Type Description
id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid

Retrieve Bundle Data

Get data entered into fields for a completed Bundle

Parameters

Name Key Required Type Description
Bundle Slug
bundleSlug True string

The slug that uniquely identifies the Bundle

Returns

Name Path Type Description
array of object
attachments
attachments array of object

An array of file attachments for an attachment field, or null

ext
attachments.ext string

The file extension

is_image
attachments.is_image boolean

true if this attachment file is an image

name
attachments.name string

File name of the attachment

num
attachments.num integer

The order in which the file was added, if there we're multiple uploads for a single attachment field (for instance, a photo for each page of a document taken with a webcam)

size
attachments.size integer

Size of the file, in bytes

url
attachments.url url

A URL that can be used temporarily to download the attachment file

doc_key
doc_key string

The key uniquely identifying this document in the Bundle (from the original BundleRequest)

field_key
field_key string

The key uniquely identifying the field in the Document (either as specified in the original DocumentRequestField in the DocumentRequest in BundleRequest, or as configured on the DocumentTemplate)

filled_by
filled_by string

The Packet key of the signer that entered the value for this field. If the field value was an 'initial_value' not edited by a signer, the value is 'initial'. If the field value was the default value configured on a DocumentTemplate, the filler is 'default'.

kind
kind string

The kind of field

label
label string

The label of the field (possibly blank)

packet_id
packet_id

The Packet id of the signer that entered the value for this field, or null if the field value was not filled in by a signer (ie, it was an initial_value or defaul value).

value
value

The value of the field.

Retrieve Bundle Files

Get downloadable files for a completed Bundle

Parameters

Name Key Required Type Description
Bundle Slug
bundleSlug True string

The slug that uniquely identifies the Bundle

Returns

Name Path Type Description
array of object
expires
expires string

The time at which the link expires, as an ISO 8601 formatted time

file_url
file_url string

the URL from where the file can be downloaded

Retrieve Packet Certificate of Evidence

Get a link and checksum of the Certificate of Evidence for this Packet

Parameters

Name Key Required Type Description
Packet Slug
packetId True string

The slug that uniquely identifies the Packet

Returns

Send a Reminder

Send a Reminder email or SMS to a Signer. A reminder can only be sent once every hour. The reminder will be sent via the delivery method (email or SMS) and to the email address (or phone number) previously designated for this Packet.

Parameters

Name Key Required Type Description
Packet Slug
packetId True string

The slug that uniquely identifies the Packet

Returns

Update a Packet

Update a Packet (aka signer) with a new email, phone number, name or authentication options

The updated packet must still be deliverable. For instance, if you specify a deliver_via value of 'phone', but there was no phone number set in the original PacketRequest, then this request must include a phone as well, or an error will be returned.

You can change a Packet that was originally configured for embedded signing (that is, deliver_via was 'embed') to be delivered via email or SMS. However, no signing notifications or reminders will be automatically sent. You must call /packet/{packetId}/remind/ to send a signing notification email (or SMS).

If this Signer is associated with a Person, the person will be updated as well - the Person name will be changed (if provided) and any new email or phone number will be added.

Parameters

Name Key Required Type Description
Packet Slug
packetId True string

The slug that uniquely identifies the Packet

body
body

Returns

Update a Person

Update the Person with new data. NOTE that any contact channels that are omitted from this request will be DELETED. If you don't want to replace all data on the Person, you probably want to use PATCH instead.

Parameters

Name Key Required Type Description
Person ID
personId True uuid

The ID that uniquely identifies the Person

email
email email
id
id uuid
kind
kind string

em for email. mp for phone.

phone
phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

Returns

Name Path Type Description
channels
channels array of object
email
channels.email email
id
channels.id uuid
kind
channels.kind string

em for email. mp for phone.

phone
channels.phone phone
id
id uuid
is_user
is_user boolean

True if this Person is associated with a BlueInk User

metadata
metadata object

Metadata to associate with this person. Metadata can be used in SmartFill to automatically populate documents. See SmartFill documentation for details.

name
name string

The name of the person

Update a Webhook

Update the Webhook with new data. NOTE that any subscriptions that are omitted from this request will be DELETED. If you don't want to replace all data on the Webhook, you probably want to use PATCH instead.

Parameters

Name Key Required Type Description
Webhook ID
webhookId True uuid

The ID that uniquely identifies the Webhook

enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Returns

Name Path Type Description
enabled
enabled boolean
event_types
event_types array of string

types of events that will fire the webhook

extra_headers
extra_headers array of object
id
extra_headers.id uuid
name
extra_headers.name string

must adhere to RFC 7230

order
extra_headers.order integer
value
extra_headers.value string

must adhere to RFC 7230

webhook
extra_headers.webhook uuid
id
id uuid
json
json boolean
url
url url

should be the full URL, including http/https

Update a WebhookExtraHeader

Update the WebhookExtraHeader with new data

Parameters

Name Key Required Type Description
WebhookExtraHeader ID
webhookExtraHeaderId True uuid

The ID that uniquely identifies the WebhookExtraHeader

id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid

Returns

Name Path Type Description
id
id uuid
name
name string

must adhere to RFC 7230

order
order integer
value
value string

must adhere to RFC 7230

webhook
webhook uuid