Customer

The person who will be receiving the signing action.

Get customer

get

Get specific customer details

Authorizations

OAuth2authorizationCodeRequired

FuseSign OAuth 2. Use this for most implementations.

Authorization URL: Token URL: Refresh URL:

Query parameters

TenantIdstring · guidRequired

FuseSign Tenant Id

Example: 1347a03f-523d-4316-9608-e81c8f996055

CustomerIdstring · guidRequired

Customer Id

Example: c4b8c524-dfd5-475b-847e-571d900beade

Responses

200

Success

application/json

CustomerIdstring · guidOptional

Customer ID

TenantIdstring · guidOptional

Customer tenant ID

Namestring · nullableOptional

Customer Name

Emailstring · nullableOptional

Customer Email

PhoneNumberstring · nullableOptional

Customer mobile number. Required for 2FA. If NoMobile is true this is not required. Must be in international format: [phone]

NoMobilebooleanOptional

No Mobile flag, means Phone Number is ignored

Metastring · nullableOptional

Optional external lookup ID. Can be used for searching

CannotModifybooleanOptional

Don't allow modification of this contact

Sourceone ofOptional

Customer data source

string · enumOptionalPossible values:

CustomerEditLinkstring · nullableOptional

Link to edit customer details directly

TotalLiveBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user which are yet to be actioned

TotalBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user

IsArchivedbooleanOptional

Customer is archived

PreferredNamestring · nullableOptional

Customer preferred name. The customer will be addressed by this name when signing.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

get/api/Customer/Get

GET /api/Customer/Get?TenantId=text&CustomerId=text HTTP/1.1
Host: api.fuse.work
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "CustomerId": "text",
  "TenantId": "text",
  "Name": "text",
  "Email": "text",
  "PhoneNumber": "text",
  "NoMobile": true,
  "Meta": "text",
  "CannotModify": true,
  "Source": "Manual",
  "CustomerEditLink": "text",
  "TotalLiveBundlesForCustomer": 1,
  "TotalBundlesForCustomer": 1,
  "IsArchived": true,
  "PreferredName": "text"
}

Create a new customer

post

Create a new customer record

Authorizations

OAuth2authorizationCodeRequired

FuseSign OAuth 2. Use this for most implementations.

Authorization URL: Token URL: Refresh URL:

Query parameters

TenantIdstring · guidRequired

FuseSign Tenant Id

Example: 453a4719-29f8-4b3b-a062-d2b78343383d

Body

CustomerIdstring · guid · nullableOptionalDeprecated

Namestring · min: 1Required

Customer Name (Required)

Emailstring · email · min: 1Required

Customer Email (Required)

Pattern: ^[^@]+@[^@]+$

PhoneNumberstringOptional

Customer mobile number. Required for 2FA. If NoMobile is true this is not required. Must be in international format: [phone]

NoMobilebooleanOptional

No Mobile flag, means Phone Number is ignored

Example: false

Metastring · max: 128Optional

Optional external lookup ID. Can be used for searching later. Note: This is used to uniquely identify this contact and will cause duplicate contacts if not reused

CannotModifybooleanOptional

Prevents end users from modifying this contact within the FuseSign application

Example: false

Optionsone ofOptional

Options for contact creation and validation

Example: {"IgnorePhoneNumberIfInvalid":false,"UpdateExistingCustomersByMetaMatch":false}

Responses

200

Success

application/json

CustomerIdstring · guidOptional

Customer ID

TenantIdstring · guidOptional

Customer tenant ID

Namestring · nullableOptional

Customer Name

Emailstring · nullableOptional

Customer Email

PhoneNumberstring · nullableOptional

Customer mobile number. Required for 2FA. If NoMobile is true this is not required. Must be in international format: [phone]

NoMobilebooleanOptional

No Mobile flag, means Phone Number is ignored

Metastring · nullableOptional

Optional external lookup ID. Can be used for searching

CannotModifybooleanOptional

Don't allow modification of this contact

Sourceone ofOptional

Customer data source

string · enumOptionalPossible values:

CustomerEditLinkstring · nullableOptional

Link to edit customer details directly

TotalLiveBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user which are yet to be actioned

TotalBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user

IsArchivedbooleanOptional

Customer is archived

PreferredNamestring · nullableOptional

Customer preferred name. The customer will be addressed by this name when signing.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

post/api/Customer/Create

POST /api/Customer/Create?TenantId=text HTTP/1.1
Host: api.fuse.work
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 195

{
  "CustomerId": null,
  "Name": "",
  "Email": "",
  "PhoneNumber": "",
  "NoMobile": false,
  "Meta": "",
  "CannotModify": false,
  "Options": {
    "IgnorePhoneNumberIfInvalid": false,
    "UpdateExistingCustomersByMetaMatch": false
  }
}

{
  "CustomerId": "text",
  "TenantId": "text",
  "Name": "text",
  "Email": "text",
  "PhoneNumber": "text",
  "NoMobile": true,
  "Meta": "text",
  "CannotModify": true,
  "Source": "Manual",
  "CustomerEditLink": "text",
  "TotalLiveBundlesForCustomer": 1,
  "TotalBundlesForCustomer": 1,
  "IsArchived": true,
  "PreferredName": "text"
}

Search customer

get

Search for customer based on Name/Email/Phone details

Authorizations

OAuth2authorizationCodeRequired

FuseSign OAuth 2. Use this for most implementations.

Authorization URL: Token URL: Refresh URL:

Query parameters

TenantIdstring · guidRequired

FuseSign Tenant Id

Example: fee2d65f-7b66-4a88-93ca-806513b83f06

SearchStringstringRequired

Wildcard search text

CollapseDuplicatesbooleanRequired

Collapse any duplicate records

Example: false

ExcludeArchivedbooleanRequired

Exclude archived contacts

Example: true

IncludeLiveBundleCountboolean · nullableOptional

Include live bundle count

IncludeBundleCountsboolean · nullableOptional

Include live bundle count

Responses

200

Success

application/json

CustomerIdstring · guidOptional

Customer ID

TenantIdstring · guidOptional

Customer tenant ID

Namestring · nullableOptional

Customer Name

Emailstring · nullableOptional

Customer Email

PhoneNumberstring · nullableOptional

Customer mobile number. Required for 2FA. If NoMobile is true this is not required. Must be in international format: [phone]

NoMobilebooleanOptional

No Mobile flag, means Phone Number is ignored

Metastring · nullableOptional

Optional external lookup ID. Can be used for searching

CannotModifybooleanOptional

Don't allow modification of this contact

Sourceone ofOptional

Customer data source

string · enumOptionalPossible values:

CustomerEditLinkstring · nullableOptional

Link to edit customer details directly

TotalLiveBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user which are yet to be actioned

TotalBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user

IsArchivedbooleanOptional

Customer is archived

PreferredNamestring · nullableOptional

Customer preferred name. The customer will be addressed by this name when signing.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

get/api/Customer/Search

GET /api/Customer/Search?TenantId=text&SearchString=text&CollapseDuplicates=true&ExcludeArchived=true HTTP/1.1
Host: api.fuse.work
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "CustomerId": "text",
    "TenantId": "text",
    "Name": "text",
    "Email": "text",
    "PhoneNumber": "text",
    "NoMobile": true,
    "Meta": "text",
    "CannotModify": true,
    "Source": "Manual",
    "CustomerEditLink": "text",
    "TotalLiveBundlesForCustomer": 1,
    "TotalBundlesForCustomer": 1,
    "IsArchived": true,
    "PreferredName": "text"
  }
]

Search customer

get

Search for customer based on metadata field

Authorizations

OAuth2authorizationCodeRequired

FuseSign OAuth 2. Use this for most implementations.

Authorization URL: Token URL: Refresh URL:

Query parameters

TenantIdstring · guidRequired

FuseSign Tenant Id

Example: 14453219-32b1-4639-86d7-9ccbe3d47acb

MetaDataSearchstringRequired

Wildcard search text

Example: meta

Responses

200

Success

application/json

CustomerIdstring · guidOptional

Customer ID

TenantIdstring · guidOptional

Customer tenant ID

Namestring · nullableOptional

Customer Name

Emailstring · nullableOptional

Customer Email

PhoneNumberstring · nullableOptional

Customer mobile number. Required for 2FA. If NoMobile is true this is not required. Must be in international format: [phone]

NoMobilebooleanOptional

No Mobile flag, means Phone Number is ignored

Metastring · nullableOptional

Optional external lookup ID. Can be used for searching

CannotModifybooleanOptional

Don't allow modification of this contact

Sourceone ofOptional

Customer data source

string · enumOptionalPossible values:

CustomerEditLinkstring · nullableOptional

Link to edit customer details directly

TotalLiveBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user which are yet to be actioned

TotalBundlesForCustomerinteger · int32 · nullableOptional

Number of bundles assigned to the user

IsArchivedbooleanOptional

Customer is archived

PreferredNamestring · nullableOptional

Customer preferred name. The customer will be addressed by this name when signing.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

get/api/Customer/SearchByMetaData

GET /api/Customer/SearchByMetaData?TenantId=text&MetaDataSearch=text HTTP/1.1
Host: api.fuse.work
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "CustomerId": "text",
    "TenantId": "text",
    "Name": "text",
    "Email": "text",
    "PhoneNumber": "text",
    "NoMobile": true,
    "Meta": "text",
    "CannotModify": true,
    "Source": "Manual",
    "CustomerEditLink": "text",
    "TotalLiveBundlesForCustomer": 1,
    "TotalBundlesForCustomer": 1,
    "IsArchived": true,
    "PreferredName": "text"
  }
]

List country codes

get

Gets the list of all country codes supported by the platform

Authorizations

OAuth2authorizationCodeRequired

FuseSign OAuth 2. Use this for most implementations.

Authorization URL: Token URL: Refresh URL:

Responses

200

Success

application/json

string[]Optional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

get/api/Customer/GetCountryCodes

GET /api/Customer/GetCountryCodes HTTP/1.1
Host: api.fuse.work
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  "text"
]