API Create Endpoint

With our endpoint creation API, you can programmatically create new form connections. The API is suitable for use by AI tools and agents that can independently set up form endpoints.

The API returns the response as JSON, in the structure shown in Example Response.

Request

The request must be sent as a POST request with the Content-Type application/json to this address:

POST https://form.taxi/api/v1/create-endpoint

The request body must be submitted as JSON. No authentication is required.

Request Data

The following fields can be passed in the JSON body:

email (required)

The email address to which form submissions will be delivered. It also serves as the username for the newly created account.

form_name (required)

The name of the form, e.g. "Contact Form".

language (required)

The language for the account and email notifications. Possible values: de, en

website_url (optional)

The URL of the website where the form will be used.

timezone (optional)

The account timezone as an IANA timezone identifier, e.g. Europe/Vienna. Defaults to UTC if not provided.

Example Request

POST https://form.taxi/api/v1/create-endpoint
Content-Type: application/json

{
    "email": "contact@domain.com",
    "form_name": "Contact Form",
    "website_url": "https://domain.com",
    "language": "en",
    "timezone": "Europe/Vienna"
}

Example Response

If the endpoint is created successfully, the API responds with HTTP status 201 and the following JSON:

{
    "success": true,
    "endpoint_url": "https://form.taxi/s/FORM_CODE"
}

The returned endpoint_url is used directly as the action attribute of the HTML form:

<form action="https://form.taxi/s/FORM_CODE" method="POST">
    ...
</form>

Error Codes

If the request fails, the response contains an error code in the error field:

HTTP Status	Error Code	Meaning
400	content_error	The request body could not be parsed as JSON.
409	email_exists	An account with this email address is already registered.
415	contenttype_error	The Content-Type header is missing or is not application/json.
422	validation_error	Invalid or missing required fields.

Example: Email Already Registered (409)

{
    "success": false,
    "error": "email_exists",
    "message": "This email address is already registered. Please log in to create an endpoint: https://form.taxi/panel/login"
}

OpenAPI Specification

The complete specification of this API is available here in OpenAPI format:

• OpenAPI Specification (HTML)
• OpenAPI Definition File (YAML)