post https://api.streak.com/api/v2/teams//contacts/
Create a new contact. All contacts are scoped to a particular team so a teamKey
is required. When creating a contact you can provide all of the contact info in a single call. See the possible parameters below.
Contacts must have at least one of name
or emailaddresses
set.
Note: Including the parameter getIfExisting
limits the parameters you can include in the call.
Content Type and Auth
Make sure to include
-H "Content-Type: application/json"
and your authorization in any request you make on your own.
Error | Example | Details |
---|---|---|
Missing parameters | { "error": "Insufficient params for TeamContact", "success": false } | You might be missing the teamKey, emailAddresses, givenName, or familyName |
Incorrect teamKey, API path has something mis-spelled or missing | { "success": false } OR { "error": "Invalid API path specified", "success": false } | We can't find the teamKey you've provided. |
Need more information on the contact | "Need to specify at least a name or email address" | We require one of the following to create a contact:givenName familyName * emailAddresses |
Need appropriate header | { "error": "Missing parameters", "success": false } | If you do not have the header-H "Content-Type: application/json" your call will return this error. |
Duplicate email addresses | { "error": "Contacts can't have duplicate emails: [email protected], "errorCode": 801, "success": false } | You can not pass duplicate email addresses, ie ["[email protected]", "[email protected]"] |
Check if contact exists?
If the
getIfExisting
parameter is included, you can ONLY pass the parameter ofemailAddresses
.