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

importConfigId

The import configuration identifier.


Type integer
Additional info
Required

The contacts you would like to import.

FirstName

Given name.


Type string
Additional info

Max length: 50

LastName

Family name.


Type string
Additional info

Max length: 50

Email

Email address.


Type string
Additional info

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

Phone

E.164 phone number.


Type string
Additional info

Max length: 20

Gender

M or F.


Type string
DateOfBirth

Date of birth.


Type date
Additional info

Format as YYYY-MM-DD

Street

Street.


Type string
Additional info

Max length: 50

HouseNumber

House number.


Type string
Additional info

Max length: 6

Suite

Suite or appartment.


Type string
Additional info

Max length: 4

PostalCode

Postal code.


Type string
Additional info

Max length: 15

City

City.


Type string
Additional info

Max length: 50

State

ISO 3166-2: US State code.


Type string
Additional info

Max length: 2

Province

Province.


Type string
Additional info

Max length: 50

Country

ISO 3166-1 Country Code.


Type string
Additional info

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

CustomField2

Type string
Additional info

Max length: 256

CustomField3

Type string
Additional info

Max length: 256

CustomField4

Type string
Additional info

Max length: 256

CustomField5

Type string
Additional info

Max length: 256

CustomField6

Type string
Additional info

Max length: 256

CustomField7

Type string
Additional info

Max length: 256

CustomField8

Type string
Additional info

Max length: 256

CustomField9

Type string
Additional info

Max length: 256

CustomField10

Type string
Additional info

Max length: 256

CustomField11

Type string
Additional info

Max length: 256

CustomField12

Type string
Additional info

Max length: 256

CustomField13

Type string
Additional info

Max length: 256

CustomField14

Type string
Additional info

Max length: 256

CustomField15

Type string
Additional info

Max length: 256

CustomField16

Type string
Additional info

Max length: 256

CustomField17

Type string
Additional info

Max length: 256

CustomField18

Type string
Additional info

Max length: 256

CustomField19

Type string
Additional info

Max length: 256

CustomField20

Type string
Additional info

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-12T12:20:15.0712681Z",
    "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-12T12:20:15.0712681Z",
    "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-12T12:20:15.0712681+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-12T12:20:15.0712681+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

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


Meta

The metadata such as paging parameters, status code, timestamp,... which are related to this request.


Type MetaData
Data

The actual data returned by the request.


Type 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
Sample:
{
  "Meta": {
    "Status": 1,
    "TotalRowCount": 1,
    "Limit": 1,
    "Offset": 1,
    "TotalPageCount": 1,
    "StartRec": 1,
    "StopRec": 1,
    "Timestamp": "2024-12-12T12:20:15.0722692Z",
    "IsFiltered": true
  },
  "Data": {
    "QueueItemId": 1,
    "StatusId": 3,
    "DateQueued": "2024-12-12T12:20:15.0722692Z",
    "DateStarted": "2024-12-12T12:20:15.0722692Z",
    "DateComplete": "2024-12-12T12:20:15.0722692Z",
    "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-12T12:20:15.0722692+00:00</DateComplete>
    <DateQueued>2024-12-12T12:20:15.0722692+00:00</DateQueued>
    <DateStarted>2024-12-12T12:20:15.0722692+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-12T12:20:15.0722692+00:00</Timestamp>
    <TotalPageCount>1</TotalPageCount>
    <TotalRowCount>1</TotalRowCount>
  </Meta>
</Payload>

Related Examples

Title
Import contacts in bulk