Create signup

curl --request POST \
  --url https://app.finta.com/api/v1/signups \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "founder@acme.com",
  "app": "codex"
}
'

import requests

url = "https://app.finta.com/api/v1/signups"

payload = {
    "email": "founder@acme.com",
    "app": "codex"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'founder@acme.com', app: 'codex'})
};

fetch('https://app.finta.com/api/v1/signups', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.finta.com/api/v1/signups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'founder@acme.com',
    'app' => 'codex'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.finta.com/api/v1/signups"

	payload := strings.NewReader("{\n  \"email\": \"founder@acme.com\",\n  \"app\": \"codex\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.finta.com/api/v1/signups")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"founder@acme.com\",\n  \"app\": \"codex\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.finta.com/api/v1/signups")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"founder@acme.com\",\n  \"app\": \"codex\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "verification_sent",
  "email": "founder@acme.com",
  "expires_in_seconds": 3600,
  "mcp_url": "https://mcp.finta.com/mcp",
  "next_step": {
    "action": "open_verification_link",
    "message": "Tell the user: \"Click Activate in the email Finta just sent you at founder@acme.com.\" They click it in their own browser; never fetch the link. Then connect Finta's MCP (https://mcp.finta.com/mcp) the way your app supports; they sign in with one Allow. If your app must restart to load it, tell them exactly how to restart and come back to this chat, and call no Finta tool until then. E.g. Codex CLI: they quit (Ctrl+C twice) and run `codex mcp add finta --url https://mcp.finta.com/mcp && codex resume --last` (don't run it yourself); Claude Code: run `claude mcp add --transport http finta https://mcp.finta.com/mcp` if you haven't, then they run /mcp and pick finta. Once connected, call get_onboarding and follow next_step.message. No email? Existing accounts get none; just connect and sign in."
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_missing",
    "message": "Missing required param: email.",
    "param": "email",
    "doc_url": "https://www.finta.com/docs/api-reference/errors#parameter_missing"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_email",
    "message": "Enter a valid email address.",
    "param": "email",
    "doc_url": "https://www.finta.com/docs/api-reference/errors#invalid_email"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after the Retry-After period.",
    "doc_url": "https://www.finta.com/docs/api-reference/errors#rate_limit_exceeded"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "signups_paused",
    "message": "Sign-up through AI apps is paused. The user can sign up at https://app.finta.com/signup.",
    "doc_url": "https://www.finta.com/docs/api-reference/errors#signups_paused"
  }
}