Daylite WebsiteMarketcircle Blog
API Reference

Contact

post
https://api.marketcircle.net/v1/contacts

Create a new contact

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

See Contact for a list of attributes which are supported for contacts. Only attributes marked as Read-Write can be set using this endpoint.

Ownership

The creator of the contact will automatically be set to the user performing the request. However, a contact also has an owner, which is the user responsible for contact. See the ownership page for more details.

📘

Categories and Keywords

Categories and keywords are serialized using the category/keyword name instead of URL references. If you name a category or keyword that does not already exist, it will be created automatically.

Validation

Various validations are run on the supplied contact object. If any validations fail, then an HTTP 400 Bad Request response will be returned. Details about which validations failed will be returned in the body of the response.

Body Params
string

Preferred salutation (e.g. "Mr.", "Ms.")

string

Contacts first name

string

Contacts middle name

string

Contacts last name

string

Name suffix (e.g. "Jr.", "PhD.")

string

Legal alias

string

Casual nickname

string

Birth date, optionally including year

string

Anniversary date, optionally including year

boolean

Is the contact flagged

string

Tagline for the contact

string

Contact's hobbies

string

URL of Contact Image

string

Category name

keywords
array of strings

List of Keywords

keywords
extra_fields
object

Each extra field will use its default name even if you have customized it

emails
array of objects

Email addresses associated with the contact

emails
urls
array of objects

Website url for the contact

urls
social_profiles
array of objects

Social profiles for the contact

social_profiles
phone_numbers
array of objects

Phone numbers for the contact

phone_numbers
addresses
array of objects

Addresses associated with the contact.

addresses
string

Details for the contact.

companies
array of objects

Companies associated with the contact.

companies
opportunities
array of objects

Opportunities associated with the contact.

opportunities
projects
array of objects

Projects associated with the contact.

projects
contacts
array of objects

Contacts associated with the contact.

contacts
groups
array of objects

Groups associated with the contact.

groups
tasks
array of objects

Tasks associated with the contact.

tasks
forms
array of objects

Forms associated with the contact.

forms
notes
array of objects

Notes associated with the contact.

notes
Responses

Updated about 1 year ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 year ago