Contacts

The contact's APIs are primarily used to interact with the BoldSign application to create, update, delete and get contact details. This section demonstrates how to create contact, update contact details, delete contact details, get contact details and get contact list from your Organizations.

Create contact

post/v1/contacts/create

The create contact API is used to add contact details for adding signer details while creating document in BoldSign Application with their unique email address.

Code snippet

curl --location 'https://api.boldsign.com/v1/contacts/create' \
--header 'accept: */*' \
--header 'X-API-KEY: {your API key}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "email": "luthercooper@cubeflakes.com",
        "name": "LutherCooper",
        "phoneNumber": {
             "countryCode": "+1",
             "number": "2015550123"
        },
        "jobTitle": "Developer",
        "companyName": "CubeFlakes"
    },
    {
        "email": "hankwhite@cubeflakes.com",
        "name": "HankWhite",
        "phoneNumber": {
             "countryCode": "+1",
             "number": "2015550124"
        },
        "jobTitle": "Manager",
        "companyName": "CubeFlakes"
    }
]'
var apiClient = new ApiClient("YOUR_API_KEY");

var contactClient = new ContactClient(apiClient);

var contactDetails = new List<ContactDetails>()
{
    new ContactDetails()
    {
        Email = "luthercooper@cubeflakes.com",
        Name = "LutherCooper"
    },
};

var contactCreated = contactClient.CreateContact(contactDetails);
import boldsign

configuration = boldsign.Configuration(api_key="YOUR_API_KEY")

with boldsign.ApiClient(configuration) as api_client:

    contacts_api = boldsign.ContactsApi(api_client)
	
    contact_details = boldsign.ContactDetails(
        email="luthercooper@cubeflakes.com",
        name="LutherCooper")
    
    contact_created = contacts_api.create_contact([contact_details])
<?php require_once "vendor/autoload.php";

use BoldSign\Configuration;
use BoldSign\Api\ContactsApi;
use BoldSign\Model\{ContactDetails, PhoneNumber};

$config = new Configuration();
$config->setApiKey('YOUR_API_KEY');

$contacts_api = new ContactsApi($config);

$create_contact = new ContactDetails();
$create_contact->setEmail('luthercooper@cubeflakes.com');
$create_contact->setName('LutherCooper');
$contact_details = array($create_contact);

$contact_created = $contacts_api->createContact($contact_details);
ApiClient client = Configuration.getDefaultApiClient();  
client.setApiKey("YOUR_API_KEY");
            
ContactsApi contactsApi = new ContactsApi(client);

ContactDetails contactDetails = new ContactDetails();
contactDetails.setEmail("luthercooper@cubeflakes.com");
contactDetails.setName("LutherCooper");

CreateContactResponse contactCreated = contactsApi.createContact(Arrays.asList(contactDetails));
import { ContactsApi, ContactDetails } from "boldsign";

const contactsApi = new ContactsApi();
contactsApi.setApiKey("YOUR_API_KEY");

const contactDetails = new ContactDetails();
contactDetails.name = "LutherCooper";
contactDetails.email = "luthercooper@cubeflakes.com";

const contactCreated = contactsApi.createContact([contactDetails]);

Request body

emailstringRequiredThe email address of the user.
namestringRequiredThe name of the user

phoneNumberobject

The Phone Number of user

countryCodestringThis property represents the country code associated with the phone number.
numberstringThis property represents the actual phone number.
jobTitlestringThe jobTitle of the user
companyNamestringThe companyName of the user

Example response

200 Success

{
  "contacts": [
    {
      "id": "6797a07d-26d7-41fa-b3a8-c8f72378a7a6c_ErZHN",
      "email": "luthercooper@cubeflakes.com"
    },
    {
      "id": "6797a07d-26d7-41fa-b3a8-c8f72378a7a6c_GsSVP",
      "email": "hankwhite@cubeflakes.com"
    }
  ]
}