/send-form

Sends an email based on the specified email template and the passed form data. The email is sent via the specified email service or via the default service if default_service keyword is passed.

Resource URL

POST https://api.emailjs.com/api/v1.0/email/send-form

Request Information

Content type is 'multipart/form-data'

Rate Limit

1 request per second

Parameters

NAME	REQUIRED	DESCRIPTION
service_id	Yes	Service ID of the service through which the email should be sent. Reserved keyword default_service is supported, and should be used to use the default service, which can be set and changed via EmailJS dashboard.
template_id	Yes	Template ID of the email
user_id	Yes	Public Key of the account
accessToken	No	Private Key of the account

Response Information

Response formats is JSON or Text

Example Response

Success status:

200 "OK"

Failure status:

400 "The user_id parameter is required"

Code Example

For this example we will use jQuery library. It has ajax and supports very old browsers.

// code fragment
// the form id is myForm
$('#myForm').on('submit', function(event) {
    event.preventDefault(); // prevent reload
    
    var formData = new FormData(this);
    formData.append('service_id', 'YOUR_SERVICE_ID');
    formData.append('template_id', 'YOUR_TEMPLATE_ID');
    formData.append('user_id', 'YOUR_PUBLIC_KEY');
 
    $.ajax('https://api.emailjs.com/api/v1.0/email/send-form', {
        type: 'POST',
        data: formData,
        contentType: false, // auto-detection
        processData: false // no need to parse formData to string
    }).done(function() {
        alert('Your mail is sent!');
    }).fail(function(error) {
        alert('Oops... ' + JSON.stringify(error));
    });
});
// code fragment