Sample Email Registration API Form???

Matthew Andrade:

Okay I have seen the error's that I am getting:

<errorResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd" xmlns="http://convio.com/crm/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<code>10</code>

<message>Required field 'primary_email' missing.</message>

</errorResponse>

I have made the chnages to the form and please let me know if i'm wrong here but I added that field to the form:

<div id="contentInnerRight">

<div class="signupHeaderInner">Rabbi's eNewsletter Signup</div>

<div id="signupSection">

<form method="post" action="https://secure2.convio.net/mysite/site/CRConsAPI">

<input type="hidden" name="api_key" id="APIKEY" value="APIKEY">

<input type="hidden" name="v" id="v" value="1.0">

<input type="hidden" name="method" id="method" value="create">

<input type="hidden" name="add_group_ids" value="52141">

<input type="hidden" name="add_interest_ids" value="1421">

<table>

<tr>

<td>

<input name="primary_address" type="text" size="35" maxlength="100">

<input type="submit" value="Submit" name="Submit">

</td>

</tr>

</table>

</form>

</div>

<br />

]

</div>

Looks like you meant to add the field "primary_email" rather than "primary_address".

Gary

Adrian Cotter:

One other route to take to accomplish this -- especially if all your doing is submitting to Convio -- is to first make a survey in Convio, and then copy the HTML code for the survey form into your webpage.

Don't know if Convio would prefer we not do this... but it is easy to do.

I've always felt the survey method was something of a hack... Yeah, it works, and convio folks have recommended it several times, but when there is an API method available, it just seems to me that using the survey instead is sort low quality. The API can generally do everything the survey can do now in terms of collecting member data and grouping and setting interests... the only thing you really can't do is use the survey report to get data -- but you can use Report Writer to get at data so there isn't a good arguement there either... I don't know, sometimes what works is fine, but if Convio happens to change the Survey application, and you've copied the HTML out like that, your forms will break and you're SOL, whereas the API is supported and because they use versions flags (1.0 right now), if they change things such that existing forms break, they'll use a different version to differentiate and provide backwards compatibility. With Surveys, all the guarentee I've heard is that they don't expect to change it much........... So, I'd recommend learning how to make use of the API for external (that is, non-applicationized) data collection forms.

Noah Cooper:

The biggest benefit of using the API instead of a "hacked" Survey is error-handling -- with Survey, you can specify an ERRORURL, however, since you get back no actual error response, you have no way of knowing what field is in error. With the API on the otherhand, you get back a full error response.

Sure there are upsides to using the API. However, if in-house you lack the skills, or resources/time to set it up, then hacking the survey works. As to error handling, you can still embed the survey in a Convio page builder page, and have a backup error handling.

The other thing is that you don't have to submit it against a secure server. Which can be annoying for users if your form sits on a non-secure page.