Once you have your HelloForms form link you can start building your contact form. We're going to be using as an example url.

Set your forms action attribute to your HelloForms link e.g action="". Then you can start adding form inputs.

HelloForms has two required inputs _name and _email. Both required inputs are used for alerting you who submitted a form and what their email is.

Form Inputs

Name Description
_name Submitee's name
_email Submitee's email
_to Optional: Alternate email to send the form submission to.
_redirect Optional: URL that submitee will be redirect to when the form is submitted

File Uploads

If you're a pro user all of your forms support file uploading, whenever a user uploads a file we validate it and attach it to the submission notification email. You can also view files in your Submission Archive.

To accept files simply add an input with the file type and a random name. There are some bugs with file uploads if you have a recaptcha enabled on your HelloForms form.


If you're a pro user you can add up to three webhooks to each form. Whenever a submission is created we'll POST all of it's data to your webhook url.


We support OAuth allowing developers to create integrations with HelloForms. You can create an OAuth client on your account page. We currently only support one scope, access-form-endpoints this allows you to access all of a users form endpoints.

$query = http_build_query([
    'client_id' => 'client-id',
    'redirect_uri' => '',
    'response_type' => 'code',
    'scope' => '*',

$authorize_url = '' . $query;

Once you have an access token for a user you can perform a GET request like shown below.

$response = $client->request('GET', '/api/forms', [
    'headers' => [
        'Accept' => 'application/json',
        'Authorization' => 'Bearer '.$accessToken,

Copyright © 2018 HelloForms a product of Lynn Digital, LLC