Need An Email Marketing Solution For All Of Your Customers?

Partner With VerticalResponse!


The createCustomListField() method creates a single custom list field in the VR mailing custom list fields. You can set the custom list field size to small (25 characters), medium (125 characters) and large (255 characters); if not specified, the system defaults to medium. You can also add custom fields when calling the method createList.

Field names are case-sensitive. Standard fields are all lowercase, and custom fields’ case will depend on how you created them. For simplicity, we recommend creating all of your custom fields in lowercase.

If you are comparing your custom fields to the “List Fields” section of the VerticalResponse web application, the cases for any custom fields will match the Name column rather than the Merge Field column. (Standard fields will be all lowercase).



session_id [xsd:string] (required)
Your API session id.
field_name [xsd:string] (required)
The field name to create.
width [xsd:string]
The field width to be created. Allowed widths are “small” (25 characters), “medium” (125 characters), or “large” (255 characters). Defaults to “medium”.


The output is always true.



$vrapi->createCustomListField( {
    session_id => $sid,
    field_name => $field_name
} );


$vrapi->createCustomListField( array(
    'session_id' => $sid,
    'field_name' => $field_name
) );


   'session_id'  => sid,
   'field_name' => field_name