Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

POST: Assign Point of Contact

Avatar
Ingrid
Follow
  • December 14, 2020: Added example cURL request.
  • March 31, 2020: Added instructions for getting the values of the query parameters.

⇤ Portfolio

https://api.bitsighttech.com/ratings/v1/portfolio/contacts

This is a prerequisite for sending collaboration requests via the Enable Access Program in bulk. Use this path to assign a point of contact (primary recipient) for companies in your portfolio.

See Enable Access Program user permissions.

Parameters

*Required.

Parameter Description Values 
company_guid
Body		 Identify the recipient company that’s being tagged with a contact. [String] Company unique identifier [entity_guid]. See GET: Portfolio Details. 
friendly_name
Body		 Update the preferred name of the contact. [String] See GET: Portfolio Contacts for current user details. 
formal_name
Body		 Update the full name of the contact. [String] See GET: Portfolio Contacts for current user details. 
email
Body		 Update the email address of the contact. The email domain must match a domain that belongs to the company of the contact. [String] See GET: Portfolio Contacts for current user details.
Example: jane.doe@example.com
 
phone_number
Body		 Update the phone number of the contact. [String] See GET: Portfolio Contacts for current user details.

Example Request

cURL:

curl -X POST --data-ascii '{
  "company_guid": "1b3d260c-9e23-4e19-b3a5-a0bcf67d74d9",
  "friendly_name": "Diane",
  "formal_name": "Diane Jones",
  "email": "diane@actorsfilms.us",
  "phone_number": "555-555-5555"
 }' https://api.bitsighttech.com/ratings/v1/portfolio/contacts -u api_token: --header "Content-Type:application/json"

JSON:

{
  "company_guid": "1b3d260c-9e23-4e19-b3a5-a0bcf67d74d9",
  "friendly_name": "Diane",
  "formal_name": "Diane Jones",
  "email": "diane@actorsfilms.us",
  "phone_number": "555-555-5555"
}

Related articles