> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: post(request: WixHttpFunctionRequest)

# Method package: wixHttpFunctions

# Method menu location: wixHttpFunctions --> post

# Method Link: https://dev.wix.com/docs/velo/velo-only-apis/wix-http-functions/post.md

# Method Description:

A function that responds to requests made with the HTTP POST method.

The HTTP POST method is usually called by consumers to create a new resource.
 If defined in this way and the resource is created, the function should respond
 with a 201 (Created) status code and usually a reference to the new resource.

 Respond to the request by returning a [`WixHttpFunctionResponse`](wix-http-functions.WixHttpFunctionResponse.html)
 object you create using one of the [`response()`](wix-http-functions.html#response), [`ok()`](wix-http-functions.html#ok),
 [`created()`](wix-http-functions.html#created), [`notFound()`](wix-http-functions.html#notFound),
 [`serverError()`](wix-http-functions.html#serverError), [`badRequest()`](wix-http-functions.html#badRequest),
 or [`forbidden()`](wix-http-functions.html#forbidden) functions.

 The `post()` function is not a function that you call from your code. You define
 the function in a file named **http-functions.js** in your site's Backend section.
 The function is called when your users make HTTP requests using the associated
 URLs as described below.

 All POST requests with the following URL will be routed to this function:

 Premium sites:

 ```
 https://www.{user_domain}/_functions/
 ```

 Free sites:

 ```
 https://{user_name}.wixsite.com/{site_name}/_functions/
 ```


 > **Note:** You must publish your site at least once before using both the testing and production endpoints.
 When you make changes to production endpoints you must publish your site for them to take effect. Testing endpoints will use the latest code in the editor.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Create a POST HTTP function

```javascript
// In http-functions.js

import {created} from 'wix-http-functions';

// URL looks like:
// https://www.mysite.com/_functions/myFunction/
// or:
// https://user.wixsite.com/mysite/_functions/myFunction/
export function post_myFunction(request) {

  return request.body.text()
    .then( (body) => {

      // insert the info from the body somewhere

      return created();
    } );
}

```

## Create a POST HTTP function

```javascript
// In http-functions.js

import {created, serverError} from 'wix-http-functions';
import wixData from 'wix-data';

// URL looks like:
// https://www.mysite.com/_functions/myFunction/
// or:
// https://user.wixsite.com/mysite/_functions/myFunction/
export function post_myFunction(request) {
  let options = {
    "headers": {
      "Content-Type": "application/json"
    }
  };
  // get the request body
  return request.body.json()
  .then( (body) => {
      // insert the item in a collection
      return wixData.insert("myCollection", body);
    } )
    .then( (results) => {
      options.body = {
        "inserted": results
      };
      return created(options);
    } )
    // something went wrong
    .catch( (error) => {
      options.body = {
        "error": error
      };
      return serverError(options);
    } );
}

```

---