...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Note | ||
|---|---|---|
| ||
The response of GetFields method is different from many other MailUpSend methods because it includes "errorCode" only when call is not successful. If this inconsistency is critical for your client application you can use GetFields_st method instead. GetFields_st is the recommended choice if you are starting a new integration with MailUp. |
Method parameters
GetFields allows to retrieve the user personal data fields which have been configured in the MailUp system. This feature is useful when using applications that, in order to integrate, necessarily need to map their data structure based on MailUp personal data fields. Mapping is a one-time, preliminary operation for configuring data import to MailUp.
...
The method returns a string in XML format containing the names and IDs of the personal data fields.
...
Sample GetFields response
| Code Block | ||||
|---|---|---|---|---|
| ||||
<GetFields> <Fields> <Field Name="nome" Id ="X"/> .... </Fields> </ GetFields > |
The XML string will have the following features:
- A root node <GetFields>.
- A node <Fields>, contained in the root node.
- A series of nodes <Field> for each configured personal data field, contained in the node <Fields>. Nodes <Field> have the attributes Name and Id. The first contains the name of the personal data field, the second contains the identifier.
In case no personal data field has been configured, the node <Fields> will be empty (without nodes <Field>) in the XML string
In case of errors during the request, the XML string will have the following structure:
...
The XML string will have the following features:
- A root node <GetFields>.
- A node <Error>, contained in the root node, returning the error message.
...
| Info |
|---|
| MailUp personal data fields are always defined in string format. As a consequence, GetFields method does not return the type of personal data fields |
More sample GetFields response for the above described scenarios:
- Values returned: MailUp personal data fields and the corresponding IDs are listed. IDs are requested when importing to MailUp
...