POST 3/contacts/import/{importConfigId}

Definition

POST - 3/contacts/import/{importConfigId}

Import contacts in bulk. Depending on your import configuration you can receive a email notification on each import. You can also trace the item in the queue when requesting the result.

Required roles: Contacts (write)

Request information

Uri parameters

Name	Description	Type	Additional information
importConfigId The import configuration identifier. Type integer Additional info Required
importConfigId	The import configuration identifier.	integer	Required

Request body fields

The contacts you would like to import.

Name	Description	Type	Additional information
FirstName Given name. Type string Additional info Max length: 50
FirstName	Given name.	string	Max length: 50
LastName Family name. Type string Additional info Max length: 50
LastName	Family name.	string	Max length: 50
Email Email address. Type string Additional info Max length: 100
Email	Email address.	string	Max length: 100
LangCode ISO 639-1 language code. If empty the DefaultLanguage from the querystring will be used, if not available the language from the user who created the api key will be used. Type string Additional info Max length: 2
LangCode	ISO 639-1 language code. If empty the DefaultLanguage from the querystring will be used, if not available the language from the user who created the api key will be used.	string	Max length: 2
Phone E.164 phone number. Type string Additional info Max length: 20
Phone	E.164 phone number.	string	Max length: 20
Gender M or F. Type string
Gender	M or F.	string
DateOfBirth Date of birth. Type date Additional info Format as YYYY-MM-DD
DateOfBirth	Date of birth.	date	Format as YYYY-MM-DD
Street Street. Type string Additional info Max length: 50
Street	Street.	string	Max length: 50
HouseNumber House number. Type string Additional info Max length: 6
HouseNumber	House number.	string	Max length: 6
Suite Suite or appartment. Type string Additional info Max length: 4
Suite	Suite or appartment.	string	Max length: 4
PostalCode Postal code. Type string Additional info Max length: 15
PostalCode	Postal code.	string	Max length: 15
City City. Type string Additional info Max length: 50
City	City.	string	Max length: 50
State ISO 3166-2: US State code. Type string Additional info Max length: 2
State	ISO 3166-2: US State code.	string	Max length: 2
Province Province. Type string Additional info Max length: 50
Province	Province.	string	Max length: 50
Country ISO 3166-1 Country Code. Type string Additional info Max length: 2
Country	ISO 3166-1 Country Code.	string	Max length: 2
CustomField1 Your own metadata which can be used as a variable in the surveys, display logic and reporting. Type string Additional info Max length: 256
CustomField1	Your own metadata which can be used as a variable in the surveys, display logic and reporting.	string	Max length: 256
CustomField2 Type string Additional info Max length: 256
CustomField2		string	Max length: 256
CustomField3 Type string Additional info Max length: 256
CustomField3		string	Max length: 256
CustomField4 Type string Additional info Max length: 256
CustomField4		string	Max length: 256
CustomField5 Type string Additional info Max length: 256
CustomField5		string	Max length: 256
CustomField6 Type string Additional info Max length: 256
CustomField6		string	Max length: 256
CustomField7 Type string Additional info Max length: 256
CustomField7		string	Max length: 256
CustomField8 Type string Additional info Max length: 256
CustomField8		string	Max length: 256
CustomField9 Type string Additional info Max length: 256
CustomField9		string	Max length: 256
CustomField10 Type string Additional info Max length: 256
CustomField10		string	Max length: 256
CustomField11 Type string Additional info Max length: 256
CustomField11		string	Max length: 256
CustomField12 Type string Additional info Max length: 256
CustomField12		string	Max length: 256
CustomField13 Type string Additional info Max length: 256
CustomField13		string	Max length: 256
CustomField14 Type string Additional info Max length: 256
CustomField14		string	Max length: 256
CustomField15 Type string Additional info Max length: 256
CustomField15		string	Max length: 256
CustomField16 Type string Additional info Max length: 256
CustomField16		string	Max length: 256
CustomField17 Type string Additional info Max length: 256
CustomField17		string	Max length: 256
CustomField18 Type string Additional info Max length: 256
CustomField18		string	Max length: 256
CustomField19 Type string Additional info Max length: 256
CustomField19		string	Max length: 256
CustomField20 Type string Additional info Max length: 256
CustomField20		string	Max length: 256

Sample:

[
  {
    "FirstName": "John",
    "LastName": "Doe",
    "Email": "john.doe@mail.com",
    "LangCode": "en",
    "Phone": "+1-202-555-0117",
    "Gender": "M",
    "DateOfBirth": "2024-12-21T17:22:34.3339489Z",
    "Street": "Main Street",
    "HouseNumber": "123",
    "Suite": "B",
    "PostalCode": "98765-4321",
    "City": "Anytown",
    "State": "CA",
    "Province": "California",
    "Country": "US",
    "CustomField1": "sample string 1",
    "CustomField2": "sample string 2",
    "CustomField3": "sample string 3",
    "CustomField4": "sample string 4",
    "CustomField5": "sample string 5",
    "CustomField6": "sample string 6",
    "CustomField7": "sample string 7",
    "CustomField8": "sample string 8",
    "CustomField9": "sample string 9",
    "CustomField10": "sample string 10",
    "CustomField11": "sample string 11",
    "CustomField12": "sample string 12",
    "CustomField13": "sample string 13",
    "CustomField14": "sample string 14",
    "CustomField15": "sample string 15",
    "CustomField16": "sample string 16",
    "CustomField17": "sample string 17",
    "CustomField18": "sample string 18",
    "CustomField19": "sample string 19",
    "CustomField20": "sample string 20"
  },
  {
    "FirstName": "John",
    "LastName": "Doe",
    "Email": "john.doe@mail.com",
    "LangCode": "en",
    "Phone": "+1-202-555-0117",
    "Gender": "M",
    "DateOfBirth": "2024-12-21T17:22:34.3339489Z",
    "Street": "Main Street",
    "HouseNumber": "123",
    "Suite": "B",
    "PostalCode": "98765-4321",
    "City": "Anytown",
    "State": "CA",
    "Province": "California",
    "Country": "US",
    "CustomField1": "sample string 1",
    "CustomField2": "sample string 2",
    "CustomField3": "sample string 3",
    "CustomField4": "sample string 4",
    "CustomField5": "sample string 5",
    "CustomField6": "sample string 6",
    "CustomField7": "sample string 7",
    "CustomField8": "sample string 8",
    "CustomField9": "sample string 9",
    "CustomField10": "sample string 10",
    "CustomField11": "sample string 11",
    "CustomField12": "sample string 12",
    "CustomField13": "sample string 13",
    "CustomField14": "sample string 14",
    "CustomField15": "sample string 15",
    "CustomField16": "sample string 16",
    "CustomField17": "sample string 17",
    "CustomField18": "sample string 18",
    "CustomField19": "sample string 19",
    "CustomField20": "sample string 20"
  }
]

Sample:

<ArrayOfUpdateContact xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <UpdateContact>
    <City>Anytown</City>
    <Country>US</Country>
    <CustomField1>sample string 1</CustomField1>
    <CustomField10>sample string 10</CustomField10>
    <CustomField11>sample string 11</CustomField11>
    <CustomField12>sample string 12</CustomField12>
    <CustomField13>sample string 13</CustomField13>
    <CustomField14>sample string 14</CustomField14>
    <CustomField15>sample string 15</CustomField15>
    <CustomField16>sample string 16</CustomField16>
    <CustomField17>sample string 17</CustomField17>
    <CustomField18>sample string 18</CustomField18>
    <CustomField19>sample string 19</CustomField19>
    <CustomField2>sample string 2</CustomField2>
    <CustomField20>sample string 20</CustomField20>
    <CustomField3>sample string 3</CustomField3>
    <CustomField4>sample string 4</CustomField4>
    <CustomField5>sample string 5</CustomField5>
    <CustomField6>sample string 6</CustomField6>
    <CustomField7>sample string 7</CustomField7>
    <CustomField8>sample string 8</CustomField8>
    <CustomField9>sample string 9</CustomField9>
    <DateOfBirth>2024-12-21T17:22:34.3339489+00:00</DateOfBirth>
    <Email>john.doe@mail.com</Email>
    <FirstName>John</FirstName>
    <Gender>M</Gender>
    <HouseNumber>123</HouseNumber>
    <LangCode>en</LangCode>
    <LastName>Doe</LastName>
    <Phone>+1-202-555-0117</Phone>
    <PostalCode>98765-4321</PostalCode>
    <Province>California</Province>
    <State>CA</State>
    <Street>Main Street</Street>
    <Suite>B</Suite>
  </UpdateContact>
  <UpdateContact>
    <City>Anytown</City>
    <Country>US</Country>
    <CustomField1>sample string 1</CustomField1>
    <CustomField10>sample string 10</CustomField10>
    <CustomField11>sample string 11</CustomField11>
    <CustomField12>sample string 12</CustomField12>
    <CustomField13>sample string 13</CustomField13>
    <CustomField14>sample string 14</CustomField14>
    <CustomField15>sample string 15</CustomField15>
    <CustomField16>sample string 16</CustomField16>
    <CustomField17>sample string 17</CustomField17>
    <CustomField18>sample string 18</CustomField18>
    <CustomField19>sample string 19</CustomField19>
    <CustomField2>sample string 2</CustomField2>
    <CustomField20>sample string 20</CustomField20>
    <CustomField3>sample string 3</CustomField3>
    <CustomField4>sample string 4</CustomField4>
    <CustomField5>sample string 5</CustomField5>
    <CustomField6>sample string 6</CustomField6>
    <CustomField7>sample string 7</CustomField7>
    <CustomField8>sample string 8</CustomField8>
    <CustomField9>sample string 9</CustomField9>
    <DateOfBirth>2024-12-21T17:22:34.3339489+00:00</DateOfBirth>
    <Email>john.doe@mail.com</Email>
    <FirstName>John</FirstName>
    <Gender>M</Gender>
    <HouseNumber>123</HouseNumber>
    <LangCode>en</LangCode>
    <LastName>Doe</LastName>
    <Phone>+1-202-555-0117</Phone>
    <PostalCode>98765-4321</PostalCode>
    <Province>California</Province>
    <State>CA</State>
    <Street>Main Street</Street>
    <Suite>B</Suite>
  </UpdateContact>
</ArrayOfUpdateContact>

Response information

Response body fields

Payload containining a QueueItem which you can use to get the result of your import.

Name	Description	Type
Meta The metadata such as paging parameters, status code, timestamp,... which are related to this request. Type MetaData
Meta	The metadata such as paging parameters, status code, timestamp,... which are related to this request.	MetaData
Data The actual data returned by the request. Type QueueItem
Data	The actual data returned by the request.	QueueItem
Links HATEOAS related to this object. It wil contain relevant url's such as previous and next page for paged results, create/update/delete action. These url's can be used in your application for the next steps in your application logic. Type Hateoas
Links	HATEOAS related to this object. It wil contain relevant url's such as previous and next page for paged results, create/update/delete action. These url's can be used in your application for the next steps in your application logic.	Hateoas

Response body samples

JSON
XML

Sample:

{
  "Meta": {
    "Status": 1,
    "TotalRowCount": 1,
    "Limit": 1,
    "Offset": 1,
    "TotalPageCount": 1,
    "StartRec": 1,
    "StopRec": 1,
    "Timestamp": "2024-12-21T17:22:34.3349602Z",
    "IsFiltered": true
  },
  "Data": {
    "QueueItemId": 1,
    "StatusId": 3,
    "DateQueued": "2024-12-21T17:22:34.3349602Z",
    "DateStarted": "2024-12-21T17:22:34.3349602Z",
    "DateComplete": "2024-12-21T17:22:34.3349602Z",
    "ProgressPercent": 5,
    "ProgressText": "sample string 6",
    "ResultUrl": "sample string 7"
  }
}

Sample:

<Payload xmlns:i="http://www.w3.org/2001/XMLSchema-instance" z:Id="i1" xmlns:z="http://schemas.microsoft.com/2003/10/Serialization/">
  <Data z:Id="i2">
    <DateComplete>2024-12-21T17:22:34.3349602+00:00</DateComplete>
    <DateQueued>2024-12-21T17:22:34.3349602+00:00</DateQueued>
    <DateStarted>2024-12-21T17:22:34.3349602+00:00</DateStarted>
    <ProgressPercent>5</ProgressPercent>
    <ProgressText>sample string 6</ProgressText>
    <QueueItemId>1</QueueItemId>
    <ResultUrl>sample string 7</ResultUrl>
    <StatusId>3</StatusId>
  </Data>
  <Meta>
    <IsFiltered>true</IsFiltered>
    <Limit>1</Limit>
    <Offset>1</Offset>
    <StartRec>1</StartRec>
    <Status>1</Status>
    <StopRec>1</StopRec>
    <Timestamp>2024-12-21T17:22:34.3349602+00:00</Timestamp>
    <TotalPageCount>1</TotalPageCount>
    <TotalRowCount>1</TotalRowCount>
  </Meta>
</Payload>

Related Examples

Title
Import contacts in bulk

Definition

POST - 3/contacts/import/{importConfigId}

Request information

Uri parameters

Request body fields

Request body samples

JSON

XML

Response information

Response body fields

Response body samples

JSON

XML

Related Examples