POST http://webapi.mymarketing.co.il/api/external/group/{groupId}
Add contact to group with the given external id and external name. Limited to 1000 contacts per call.
Request Information
URI Parameters
Name
Description
Type
Additional information
groupId
Group id. Can be found using the endpoint "Get account's groups" or in the UI (go to Contacts->Groups->click on the group's name -> you'll find the id int the URL)
integer
Required
Body Parameters
Contacts information
ExternalListName
Description
Type
Additional information
Request Formats
application/json, text/json
Sample:
{ "contacts": [ { "externalId": "sample string 1", "externalName": "sample string 2" }, { "externalId": "sample string 1", "externalName": "sample string 2" } ] }
application/xml, text/xml
Sample:
<ExternalList xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ActiveTrail.RESTfulApi.Models"> <contacts> <ExternalBase> <externalId>sample string 1</externalId> <externalName>sample string 2</externalName> </ExternalBase> <ExternalBase> <externalId>sample string 1</externalId> <externalName>sample string 2</externalName> </ExternalBase> </contacts> </ExternalList>
application/x-www-form-urlencoded
Sample:
Sample not available.
Response Information
Resource Description
Name
Description
Type
Additional information
success
Number of success contacts
integer
Response Formats
application/json, text/json
Sample:
{ "success": 1, "contact_errors": [ { "message": "sample string 1", "contact_error": { "externalId": "sample string 1", "externalName": "sample string 2" } }, { "message": "sample string 1", "contact_error": { "externalId": "sample string 1", "externalName": "sample string 2" } } ] }
application/xml, text/xml
Sample:
<ExternalResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ActiveTrail.RESTfulApi.Models"> <contact_errors> <ExternalContactError> <contact_error> <externalId>sample string 1</externalId> <externalName>sample string 2</externalName> </contact_error> <message>sample string 1</message> </ExternalContactError> <ExternalContactError> <contact_error> <externalId>sample string 1</externalId> <externalName>sample string 2</externalName> </contact_error> <message>sample string 1</message> </ExternalContactError> </contact_errors> <success>1</success> </ExternalResult>