API Reference

Form Submission

POST https://api.web3forms.com/submit

This endpoint allows you to submit form submissions. The following are the reserved names that will trigger form functions. You may use any other names in your forms as you need and it will be forwarded to your email as-is.

Request Body

Name	Type	Description
access_key*	string	This is where you should pass your Access Key. It is required to send the form to your email address.
email	string	User Email. This will be used to set reply to address. So its easy to follow-up.
subject	string	Email Subject. It can be submitted by user or prefilled using hidden attribute.
ccemail	string	PRO feature: Add your co-workers to your email notification.
replyto	string	Reply to Email. If you don't want to use email as replyto, you can assign a custom email here.
redirect	string	URL. You can use a custom URL to redirect to a page when the form submits successfully. NOTE: Only recommended when using without JavaScript
botcheck	boolean	Hidden. To prevent Spam Submissions. Make sure its hidden by adding display:none;
attachment	file	PRO feature: Send a file.
webhook	string	PRO feature: Hidden. Trigger a webhook when form is submitted.

200 Form Submitted Successfully

{
   "statusCode":200,
   "success":true,
   "body":{
      "data":{
        [USER SUBMITTED DATA]
      },
      "message":"Email sent successfully!"
   }
}

400 Could not complete the request due to client error!

{
   "statusCode":400,
   "success":false,
   "body":{
      "data":{
        [USER SUBMITTED DATA]
      },
      "message":"Error Description"
   }
}

500 Something wrong happened in the server!

{
   "statusCode":500,
   "success":false,
   "body":{
      "data":{
        [USER SUBMITTED DATA]
      },
      "message":"Something went wrong. "
   }
}