Submitting via a Form

On your webform, use the form tag to create a form in the following format, using the following action and method.

<form action="" method="POST">

Replace the return URL parameter value with the location the user should be redirected to after a successful registration. The error URL parameter is optional. The user may be redirected to this page if the registration was unsuccessful. If this is not supplied, your user will be redirected to the return URl.

Your input fields on the form must have a name attribute set that matches the following in order to be set on the lead. Form fields may be hidden (for example, collectorkey and segment would commonly be hidden fields)

  • CollectorKey (required)
  • Segment (required)
  • FirstName (must supply firstname, lastname, or company)
  • LastName (must supply firstname, lastname, or company)
  • Company (must supply firstname, lastname, or company)
  • Title
  • Email
  • Phone
  • Country
  • Address1
  • Address2
  • City
  • State
  • PostalCode
  • Source
  • CustomField1
  • CustomField2
  • CustomField3
  • Description

Below is the HTML for a very basic form with a hidden collectorkey and segment field, and a firstname field that a user can fill out.

<table class=”alignleft” style=”width: 994px; border-color: #000000;” border=”.5px”><colgroup align=”left”> <col style=”background-color: palegreen;” /> <col style=”background-color: white;” /> </colgroup>

You may create your own forms, style them as you’d like, and host them anywhere outside of Aprimo DM and still allow leads to be submitted into Aprimo DM’s Brand Lead Hub.

Note that you may not use javascript to invoke this endpoint in a script running a client browser as the lead waypoint API does not accept cross-site javascript requests.