{"_id":"560455090c78b00d0039b18b","editedParams":true,"editedParams2":true,"__v":15,"parentDoc":null,"project":"54870ea47810260b001c36ab","user":"54870d54f907080b00fc49cd","githubsync":"","version":{"_id":"54870ea57810260b001c36ae","project":"54870ea47810260b001c36ab","__v":20,"createdAt":"2014-12-09T15:00:53.237Z","releaseDate":"2014-12-09T15:00:53.237Z","categories":["54870ea57810260b001c36af","5487116f7810260b001c36b5","548711797810260b001c36b6","548711807810260b001c36b7","548713127810260b001c36bd","548713247810260b001c36be","548713aa7810260b001c36c0","548713c2f907080b00fc49d5","548713eef907080b00fc49d9","54871a0db3441a1f00f20d78","54871b15b3441a1f00f20d7e","54871cbeb3441a1f00f20d87","548817fac178b40b00aa2eec","558a6dd975eaf50d004e4bf5","558a6e37dbe5b63700f8d1fe","56795d8c07bf6a0d0083ee9e","583e9d764ced340f00b05a5c","5d1f3f70b4648901728803b7","5d22f7db4c9e14005111e34f","5d22fa62a541770012a07464"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"558a6dd975eaf50d004e4bf5","version":"54870ea57810260b001c36ae","pages":["558a6e098d30cb2300873e1a","558a6e88dbe5b63700f8d201","558a6e9275eaf50d004e4bfa","558a6e9a8d30cb2300873e1c","558a79f2dbe5b63700f8d23f","5592abfb6bf22f170075b823","55a65e4580c8a30d00b32618","55ba22f804775a2f006280aa","55ba2648b3612925009d66f0","56045138e416560d00fa6484","560452e4e5102a0d0070f965","560455090c78b00d0039b18b","56176873a410c90d00c612aa","56176a014d9e4a17002a0e05","5628d38e0653060d00a2f7d9","5628d5d748742a0d0047456d","56a669cffb12a40d006c4826"],"__v":17,"project":"54870ea47810260b001c36ab","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-06-24T08:44:09.019Z","from_sync":false,"order":5,"slug":"api","title":"API"},"updatedAt":"2019-07-08T08:09:00.208Z","metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-24T19:54:49.298Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"post","results":{"codes":[]},"settings":"","auth":"required","params":[{"_id":"560455090c78b00d0039b18f","ref":"","in":"body","required":true,"desc":"Your API key","default":"YOUR KEY","type":"string","name":"auth_token"},{"_id":"560455090c78b00d0039b18e","ref":"","in":"body","required":true,"desc":"Name of the contact","default":"John Doe","type":"string","name":"contact_detail.name"},{"_id":"560455090c78b00d0039b18d","ref":"","in":"body","required":true,"desc":"The role you want to assign to this contact. If the role is not yet existing in your account it will be created.","default":"Contractor","type":"string","name":"contact_detail.contact_detail_type"},{"_id":"56165b18a6767c0d001669e0","ref":"","in":"body","required":false,"desc":"","default":"Interior Work","type":"string","name":"contact_detail.secondary_type"},{"_id":"56165b2921e9110d00780322","ref":"","in":"body","required":false,"desc":"","default":"john:::at:::due.com","type":"string","name":"contact_detail.email"},{"_id":"561659b21651730d0050493f","ref":"","in":"body","required":false,"desc":"Array of all the site ID's you want to link this contact to","default":"[1, 2]","type":"object","name":"contact_detail.site_ids"},{"_id":"561659b21651730d0050493e","ref":"","in":"body","required":false,"desc":"Array of all the site UUID's you want to link this contact to","default":"[uuid1, uuid2]","type":"object","name":"contact_detail.site_uuids"},{"_id":"59c39254b2b45c0010b7b87e","ref":"","in":"body","required":false,"desc":"Array of all the site client_internal_unique_ids you want to link this contact to. Use it instead the list of site ids.","default":"[client_internal_unique_id1, client_internal_unique_id2]","type":"array_object","name":"contact_detail.site_client_internal_unique_ids"},{"_id":"56165b18a6767c0d001669e2","ref":"","in":"body","required":false,"desc":"Phone number","default":"123.4.5.67890","type":"string","name":"contact_detail.cellphone_number"},{"_id":"56165b18a6767c0d001669e1","ref":"","in":"body","required":false,"desc":"","default":"Microsoft INC","type":"string","name":"contact_detail.company_name"},{"_id":"56165b18a6767c0d001669df","ref":"","in":"body","required":false,"desc":"","default":"","type":"string","name":"contact_detail.additional_info"},{"_id":"56165b18a6767c0d001669de","ref":"","in":"body","required":false,"desc":"Your external ID. Only applicable if working with Excel upload for importing contacts","default":"","type":"string","name":"contact_detail.external_id"},{"_id":"5c40766d9c95f700513cac86","ref":"","in":"body","required":false,"desc":"Fax","default":"123 456","type":"string","name":"contact_detail.fax_number"},{"_id":"5c4076b76681f2006334e869","ref":"","in":"body","required":false,"desc":"full address","default":"Main Street 33, 1001 New York","type":"string","name":"contact_detail.address"}],"url":"/contact_details"},"isReference":true,"order":11,"body":"","excerpt":"","slug":"creating-a-contact","type":"endpoint","title":"Creating a contact"}

postCreating a contact


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

auth_token:
required
stringYOUR KEY
Your API key
contact_detail.name:
required
stringJohn Doe
Name of the contact
contact_detail.contact_detail_type:
required
stringContractor
The role you want to assign to this contact. If the role is not yet existing in your account it will be created.
contact_detail.secondary_type:
stringInterior Work
contact_detail.email:
stringjohn@due.com
contact_detail.site_ids:
object[1, 2]
Array of all the site ID's you want to link this contact to
contact_detail.site_uuids:
object[uuid1, uuid2]
Array of all the site UUID's you want to link this contact to
contact_detail.site_client_internal_unique_ids:
array of objects[client_internal_unique_id1, client_internal_unique_id2]
Array of all the site client_internal_unique_ids you want to link this contact to. Use it instead the list of site ids.
contact_detail.cellphone_number:
string123.4.5.67890
Phone number
contact_detail.company_name:
stringMicrosoft INC
contact_detail.additional_info:
string
contact_detail.external_id:
string
Your external ID. Only applicable if working with Excel upload for importing contacts
contact_detail.fax_number:
string123 456
Fax
contact_detail.address:
stringMain Street 33, 1001 New York
full address

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}