Overview

This method allows you to add a new contact to an existing customer in Komet Sales. 

Request

https://api.kometsales.com/api/customer.contact.add

  • Method: POST
  • Content-Type: application/json

Input Parameters:

  • authenticationToken (required)(string:50): Komet Sales security token.
  • customerId (required) (integer:20): customer ID. You can obtain this value from the customer.list API method.
  • name (required)(string:200): name of the contact.
  • type (required)(string:200): contact type (A/P, Buyer, etc). You need to send a contact type valid that exists in the system. 
  • phone (optional)(string:200): phone number of the contact.
  • ext (optional)(string:50): extension phone number of the contact.
  • mobile (optional)(string:50): mobile phone number of the contact.
  • fax (optional)(string:50): fax number of the contact.
  • email (optional)(string:50): e-mail address of the contact.
  • description (optional)(string:200): additional description about the contact. 
  • instantMessaging (optional)(string:200): Number for instant messaging. 
  • emailPOD (optional)(boolean): identifies if the contact will receive PODs. 

 

Sample
{
    "authenticationToken": "token_info_goes_here", 
    "customerId":6326, 
    "name": "Joe Smith",
    "type": "Buyer",
    "phone": "594-123-0982",
    "ext": "345",
    "mobile": "305-0112-0982",
    "fax": "594-123-0112",
    "email": "contact@mydomain.com",
    "description": "nothing special",
    "instantMessaging": "594-123-0982",
    "emailPOD": false
  }

Response

Output:

  • status (integer:1): transaction status. 1 for success or 0 for failure.
  • message (string:500): description of the status of the transaction.
  • contactId (integer:20): Contact internal ID that was just added.

 

Sample
{
  "status": 1,
  "message": "Contact was successfully saved",
  "contactId": 4535434
 }