Field names
Every field in Eloqua has two names: the Display Name and the Internal Name. The Display Name is the name that Eloqua users see when they are editing a contact form; the internal name is a unique name for that field. For example, Contacts and accounts both have email address fields: Eloqua may use Email Address as the display name for both entity types, but they have distinct Internal Names.
To narrow down the list of parameters to ones that are relevant for you, use query parameters to search for the fields that you need.
For example, the following request searches for contact fields whose names begin with Email:
https://secure.p03.eloqua.com/API/Bulk/2.0/contacts/fields?q="name=Email*"
Important
Search terms are case sensitive: if you search for email, you will not find any fields, because Eloqua's field names are capitalized.
The results should resemble:
{
"count": 3,
"hasMore": false,
"items": [
{
"createdAt": "1900-01-01T05:00:00.0000000Z",
"dataType": "emailAddress",
"hasNotNullConstraint": false,
"hasReadOnlyConstraint": false,
"hasUniquenessConstraint": true,
"internalName": "C_EmailAddress",
"name": "Email Address",
"statement": "{{Contact.Field(C_EmailAddress)}}",
"updatedAt": "1900-01-01T05:00:00.0000000Z",
"uri": "/contacts/fields/100001"
},
{
"createdAt": "1900-01-01T05:00:00.0000000Z",
"dataType": "string",
"hasNotNullConstraint": false,
"hasReadOnlyConstraint": false,
"hasUniquenessConstraint": false,
"internalName": "C_EmailDisplayName",
"name": "Email Display Name",
"statement": "{{Contact.Field(C_EmailDisplayName)}}",
"updatedAt": "1900-01-01T05:00:00.0000000Z",
"uri": "/contacts/fields/100005"
},
{
"createdAt": "1900-01-01T05:00:00.0000000Z",
"dataType": "string",
"hasNotNullConstraint": false,
"hasReadOnlyConstraint": false,
"hasUniquenessConstraint": false,
"internalName": "C_SFDC_EmailOptOut1",
"name": "SFDC Email Opt-Out",
"statement": "{{Contact.Field(C_SFDC_EmailOptOut1)}}",
"updatedAt": "1900-01-01T05:00:00.0000000Z",
"uri": "/contacts/fields/100043"
}
]
}
The statement field shows the Eloqua markup language representation of that field, which you can then use in an import or export
definition.