Direct Add URL

The Direct Add URL works by adding parameters that correspond to a contact you want to add, data you want to associate with the contact, and lists and SMS keywords you want to add the contact to.

These parameters are added to the Direct Add URL in the following format:
    
http://public_domain/public/?q=direct_add&fn=Public_DirectAddForm&id=IDSTRING&email=email@example.com&field1=lifetimevalue,set,129.23&list2=555555ec0000000000000000000000055f5&field3=age,set,24&list4=33333ec000000000000000000000003f3&comment=DirectAdd
				
URL breakdown:
  • The first part of the URL allows Bronto to identify your account. It can be found in the code snippet contained in the Direct Add section on the Data Exchange page. http://public_domain/public/?
  • The next few parameters, q, fn, and id allow us to know how to process the data in the URL as well as providing additional identification for your account. q=direct_add&fn=Public_DirectAddForm&id=IDSTRING
  • The rest of the URL contains parameters that you define. These parameters are the data which you want to associate with the contact.
  • The comment parameter passes source details. This comment will be visible in consent reports exported from the reporting downloads page and from the Contact Details page in the source details column.
Example of what data parameters might look like:

&email=email@example.com&field1=lifetimevalue,set,129.23&list2=555555ec0000000000000000000000055f5&field3=age,set,24&list4=33333ec000000000000000000000003f3&comment=DirectAdd
    	

Some characters that are allowed in a URL are considered reserved characters. A reserved character is a character that can have a special meaning, for example a + symbol. It's a best practice to avoid using reserved characters within an email address (except for @) and you should try to limit your contacts' ability to use them. However, if they do have a reserved character in their email you can encode the character so that it can be used in your URL. For example + would need to be encoded as %2B.

For more information on