Creates a contract

Creates a contract

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/crm/contracts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business": false,
  "firstname": "<string>",
  "surname": "<string>",
  "street": "<string>",
  "house_number": "<string>",
  "zip": "<string>",
  "city": "<string>",
  "country_id": 123,
  "billing_firstname": "<string>",
  "billing_surname": "<string>",
  "billing_street": "<string>",
  "billing_house_number": "<string>",
  "billing_zip": "<string>",
  "billing_city": "<string>",
  "billing_email": "<string>",
  "billing_phone": "<string>",
  "ext_contract_id": "<string>",
  "external_customer_id": "<string>",
  "customer_group_id": 123,
  "company_name": "<string>",
  "title": "<string>",
  "date_of_birth": "2023-12-25",
  "phone_home": "<string>",
  "phone_home_area_code": "<string>",
  "phone_mobile": "<string>",
  "phone_mobile_area_code": "<string>",
  "phone_business": "<string>",
  "phone_business_area_code": "<string>",
  "email_private": "<string>",
  "email_business": "<string>",
  "reference_field_1": "<string>",
  "reference_field_2": "<string>",
  "billing_company": "<string>",
  "billing_title": "<string>",
  "billing_country_id": 123,
  "auth_username": "<string>",
  "auth_password": "<string>",
  "advertising_agreement_mail": false,
  "advertising_agreement_phone": false,
  "advertising_agreement_email": false,
  "accept_current_agb": false,
  "accept_current_privacy_policy": false,
  "vat_identification_number": "<string>",
  "tax_code": "<string>",
  "simulation": false,
  "start_date": "2023-12-25",
  "attributes": "<string>"
}
'

import requests

url = "https://api.chargecloud.dev/api/v1/crm/contracts"

payload = {
    "business": False,
    "firstname": "<string>",
    "surname": "<string>",
    "street": "<string>",
    "house_number": "<string>",
    "zip": "<string>",
    "city": "<string>",
    "country_id": 123,
    "billing_firstname": "<string>",
    "billing_surname": "<string>",
    "billing_street": "<string>",
    "billing_house_number": "<string>",
    "billing_zip": "<string>",
    "billing_city": "<string>",
    "billing_email": "<string>",
    "billing_phone": "<string>",
    "ext_contract_id": "<string>",
    "external_customer_id": "<string>",
    "customer_group_id": 123,
    "company_name": "<string>",
    "title": "<string>",
    "date_of_birth": "2023-12-25",
    "phone_home": "<string>",
    "phone_home_area_code": "<string>",
    "phone_mobile": "<string>",
    "phone_mobile_area_code": "<string>",
    "phone_business": "<string>",
    "phone_business_area_code": "<string>",
    "email_private": "<string>",
    "email_business": "<string>",
    "reference_field_1": "<string>",
    "reference_field_2": "<string>",
    "billing_company": "<string>",
    "billing_title": "<string>",
    "billing_country_id": 123,
    "auth_username": "<string>",
    "auth_password": "<string>",
    "advertising_agreement_mail": False,
    "advertising_agreement_phone": False,
    "advertising_agreement_email": False,
    "accept_current_agb": False,
    "accept_current_privacy_policy": False,
    "vat_identification_number": "<string>",
    "tax_code": "<string>",
    "simulation": False,
    "start_date": "2023-12-25",
    "attributes": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    business: false,
    firstname: '<string>',
    surname: '<string>',
    street: '<string>',
    house_number: '<string>',
    zip: '<string>',
    city: '<string>',
    country_id: 123,
    billing_firstname: '<string>',
    billing_surname: '<string>',
    billing_street: '<string>',
    billing_house_number: '<string>',
    billing_zip: '<string>',
    billing_city: '<string>',
    billing_email: '<string>',
    billing_phone: '<string>',
    ext_contract_id: '<string>',
    external_customer_id: '<string>',
    customer_group_id: 123,
    company_name: '<string>',
    title: '<string>',
    date_of_birth: '2023-12-25',
    phone_home: '<string>',
    phone_home_area_code: '<string>',
    phone_mobile: '<string>',
    phone_mobile_area_code: '<string>',
    phone_business: '<string>',
    phone_business_area_code: '<string>',
    email_private: '<string>',
    email_business: '<string>',
    reference_field_1: '<string>',
    reference_field_2: '<string>',
    billing_company: '<string>',
    billing_title: '<string>',
    billing_country_id: 123,
    auth_username: '<string>',
    auth_password: '<string>',
    advertising_agreement_mail: false,
    advertising_agreement_phone: false,
    advertising_agreement_email: false,
    accept_current_agb: false,
    accept_current_privacy_policy: false,
    vat_identification_number: '<string>',
    tax_code: '<string>',
    simulation: false,
    start_date: '2023-12-25',
    attributes: '<string>'
  })
};

fetch('https://api.chargecloud.dev/api/v1/crm/contracts', 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://api.chargecloud.dev/api/v1/crm/contracts",
  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([
    'business' => false,
    'firstname' => '<string>',
    'surname' => '<string>',
    'street' => '<string>',
    'house_number' => '<string>',
    'zip' => '<string>',
    'city' => '<string>',
    'country_id' => 123,
    'billing_firstname' => '<string>',
    'billing_surname' => '<string>',
    'billing_street' => '<string>',
    'billing_house_number' => '<string>',
    'billing_zip' => '<string>',
    'billing_city' => '<string>',
    'billing_email' => '<string>',
    'billing_phone' => '<string>',
    'ext_contract_id' => '<string>',
    'external_customer_id' => '<string>',
    'customer_group_id' => 123,
    'company_name' => '<string>',
    'title' => '<string>',
    'date_of_birth' => '2023-12-25',
    'phone_home' => '<string>',
    'phone_home_area_code' => '<string>',
    'phone_mobile' => '<string>',
    'phone_mobile_area_code' => '<string>',
    'phone_business' => '<string>',
    'phone_business_area_code' => '<string>',
    'email_private' => '<string>',
    'email_business' => '<string>',
    'reference_field_1' => '<string>',
    'reference_field_2' => '<string>',
    'billing_company' => '<string>',
    'billing_title' => '<string>',
    'billing_country_id' => 123,
    'auth_username' => '<string>',
    'auth_password' => '<string>',
    'advertising_agreement_mail' => false,
    'advertising_agreement_phone' => false,
    'advertising_agreement_email' => false,
    'accept_current_agb' => false,
    'accept_current_privacy_policy' => false,
    'vat_identification_number' => '<string>',
    'tax_code' => '<string>',
    'simulation' => false,
    'start_date' => '2023-12-25',
    'attributes' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://api.chargecloud.dev/api/v1/crm/contracts"

	payload := strings.NewReader("{\n  \"business\": false,\n  \"firstname\": \"<string>\",\n  \"surname\": \"<string>\",\n  \"street\": \"<string>\",\n  \"house_number\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"city\": \"<string>\",\n  \"country_id\": 123,\n  \"billing_firstname\": \"<string>\",\n  \"billing_surname\": \"<string>\",\n  \"billing_street\": \"<string>\",\n  \"billing_house_number\": \"<string>\",\n  \"billing_zip\": \"<string>\",\n  \"billing_city\": \"<string>\",\n  \"billing_email\": \"<string>\",\n  \"billing_phone\": \"<string>\",\n  \"ext_contract_id\": \"<string>\",\n  \"external_customer_id\": \"<string>\",\n  \"customer_group_id\": 123,\n  \"company_name\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date_of_birth\": \"2023-12-25\",\n  \"phone_home\": \"<string>\",\n  \"phone_home_area_code\": \"<string>\",\n  \"phone_mobile\": \"<string>\",\n  \"phone_mobile_area_code\": \"<string>\",\n  \"phone_business\": \"<string>\",\n  \"phone_business_area_code\": \"<string>\",\n  \"email_private\": \"<string>\",\n  \"email_business\": \"<string>\",\n  \"reference_field_1\": \"<string>\",\n  \"reference_field_2\": \"<string>\",\n  \"billing_company\": \"<string>\",\n  \"billing_title\": \"<string>\",\n  \"billing_country_id\": 123,\n  \"auth_username\": \"<string>\",\n  \"auth_password\": \"<string>\",\n  \"advertising_agreement_mail\": false,\n  \"advertising_agreement_phone\": false,\n  \"advertising_agreement_email\": false,\n  \"accept_current_agb\": false,\n  \"accept_current_privacy_policy\": false,\n  \"vat_identification_number\": \"<string>\",\n  \"tax_code\": \"<string>\",\n  \"simulation\": false,\n  \"start_date\": \"2023-12-25\",\n  \"attributes\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.chargecloud.dev/api/v1/crm/contracts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business\": false,\n  \"firstname\": \"<string>\",\n  \"surname\": \"<string>\",\n  \"street\": \"<string>\",\n  \"house_number\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"city\": \"<string>\",\n  \"country_id\": 123,\n  \"billing_firstname\": \"<string>\",\n  \"billing_surname\": \"<string>\",\n  \"billing_street\": \"<string>\",\n  \"billing_house_number\": \"<string>\",\n  \"billing_zip\": \"<string>\",\n  \"billing_city\": \"<string>\",\n  \"billing_email\": \"<string>\",\n  \"billing_phone\": \"<string>\",\n  \"ext_contract_id\": \"<string>\",\n  \"external_customer_id\": \"<string>\",\n  \"customer_group_id\": 123,\n  \"company_name\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date_of_birth\": \"2023-12-25\",\n  \"phone_home\": \"<string>\",\n  \"phone_home_area_code\": \"<string>\",\n  \"phone_mobile\": \"<string>\",\n  \"phone_mobile_area_code\": \"<string>\",\n  \"phone_business\": \"<string>\",\n  \"phone_business_area_code\": \"<string>\",\n  \"email_private\": \"<string>\",\n  \"email_business\": \"<string>\",\n  \"reference_field_1\": \"<string>\",\n  \"reference_field_2\": \"<string>\",\n  \"billing_company\": \"<string>\",\n  \"billing_title\": \"<string>\",\n  \"billing_country_id\": 123,\n  \"auth_username\": \"<string>\",\n  \"auth_password\": \"<string>\",\n  \"advertising_agreement_mail\": false,\n  \"advertising_agreement_phone\": false,\n  \"advertising_agreement_email\": false,\n  \"accept_current_agb\": false,\n  \"accept_current_privacy_policy\": false,\n  \"vat_identification_number\": \"<string>\",\n  \"tax_code\": \"<string>\",\n  \"simulation\": false,\n  \"start_date\": \"2023-12-25\",\n  \"attributes\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chargecloud.dev/api/v1/crm/contracts")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business\": false,\n  \"firstname\": \"<string>\",\n  \"surname\": \"<string>\",\n  \"street\": \"<string>\",\n  \"house_number\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"city\": \"<string>\",\n  \"country_id\": 123,\n  \"billing_firstname\": \"<string>\",\n  \"billing_surname\": \"<string>\",\n  \"billing_street\": \"<string>\",\n  \"billing_house_number\": \"<string>\",\n  \"billing_zip\": \"<string>\",\n  \"billing_city\": \"<string>\",\n  \"billing_email\": \"<string>\",\n  \"billing_phone\": \"<string>\",\n  \"ext_contract_id\": \"<string>\",\n  \"external_customer_id\": \"<string>\",\n  \"customer_group_id\": 123,\n  \"company_name\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date_of_birth\": \"2023-12-25\",\n  \"phone_home\": \"<string>\",\n  \"phone_home_area_code\": \"<string>\",\n  \"phone_mobile\": \"<string>\",\n  \"phone_mobile_area_code\": \"<string>\",\n  \"phone_business\": \"<string>\",\n  \"phone_business_area_code\": \"<string>\",\n  \"email_private\": \"<string>\",\n  \"email_business\": \"<string>\",\n  \"reference_field_1\": \"<string>\",\n  \"reference_field_2\": \"<string>\",\n  \"billing_company\": \"<string>\",\n  \"billing_title\": \"<string>\",\n  \"billing_country_id\": 123,\n  \"auth_username\": \"<string>\",\n  \"auth_password\": \"<string>\",\n  \"advertising_agreement_mail\": false,\n  \"advertising_agreement_phone\": false,\n  \"advertising_agreement_email\": false,\n  \"accept_current_agb\": false,\n  \"accept_current_privacy_policy\": false,\n  \"vat_identification_number\": \"<string>\",\n  \"tax_code\": \"<string>\",\n  \"simulation\": false,\n  \"start_date\": \"2023-12-25\",\n  \"attributes\": \"<string>\"\n}"

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

{
  "contract": {
    "uuid": "<string>",
    "type": "energy",
    "blocked": false,
    "disabled": false,
    "billing_blocked": false,
    "dunning_locked": false,
    "account_id": 123,
    "business": false,
    "salutation": "0",
    "firstname": "<string>",
    "surname": "<string>",
    "street": "<string>",
    "house_number": "<string>",
    "zip": "<string>",
    "city": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "billing_salutation": "0",
    "billing_firstname": "<string>",
    "billing_surname": "<string>",
    "billing_street": "<string>",
    "billing_house_number": "<string>",
    "billing_zip": "<string>",
    "billing_city": "<string>",
    "billing_email": "<string>",
    "billing_phone": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "ordered_at": "2023-11-07T05:31:56Z",
    "status": "open",
    "modification_date": "2023-11-07T05:31:56Z",
    "ext_contract_id": "<string>",
    "external_id": "<string>",
    "customer_group_id": 123,
    "company_name": "<string>",
    "country_id": 123,
    "reference_field_1": "<string>",
    "reference_field_2": "<string>",
    "billing_company": "<string>",
    "billing_title": "<string>",
    "billing_country_id": 123,
    "title": "<string>",
    "tax_code": "<string>",
    "external_customer_id": "<string>",
    "auth_enabled": false,
    "auth_username": "<string>",
    "phone_home": "<string>",
    "phone_home_area_code": "<string>",
    "phone_mobile": "<string>",
    "phone_mobile_area_code": "<string>",
    "phone_business": "<string>",
    "phone_business_area_code": "<string>",
    "email_private": "<string>",
    "email_business": "<string>",
    "advertising_agreement_mail": false,
    "advertising_agreement_phone": false,
    "advertising_agreement_email": false
  },
  "customer_id": 123,
  "external_customer_id": "<string>",
  "mail_verification_needed": false,
  "contract_confirmation_needed": false
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "errors": [
    {
      "errorKey": "<string>",
      "message": "<string>",
      "parameter": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

POST

api

crm

contracts

Creates a contract

curl --request POST \
  --url https://api.chargecloud.dev/api/v1/crm/contracts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business": false,
  "firstname": "<string>",
  "surname": "<string>",
  "street": "<string>",
  "house_number": "<string>",
  "zip": "<string>",
  "city": "<string>",
  "country_id": 123,
  "billing_firstname": "<string>",
  "billing_surname": "<string>",
  "billing_street": "<string>",
  "billing_house_number": "<string>",
  "billing_zip": "<string>",
  "billing_city": "<string>",
  "billing_email": "<string>",
  "billing_phone": "<string>",
  "ext_contract_id": "<string>",
  "external_customer_id": "<string>",
  "customer_group_id": 123,
  "company_name": "<string>",
  "title": "<string>",
  "date_of_birth": "2023-12-25",
  "phone_home": "<string>",
  "phone_home_area_code": "<string>",
  "phone_mobile": "<string>",
  "phone_mobile_area_code": "<string>",
  "phone_business": "<string>",
  "phone_business_area_code": "<string>",
  "email_private": "<string>",
  "email_business": "<string>",
  "reference_field_1": "<string>",
  "reference_field_2": "<string>",
  "billing_company": "<string>",
  "billing_title": "<string>",
  "billing_country_id": 123,
  "auth_username": "<string>",
  "auth_password": "<string>",
  "advertising_agreement_mail": false,
  "advertising_agreement_phone": false,
  "advertising_agreement_email": false,
  "accept_current_agb": false,
  "accept_current_privacy_policy": false,
  "vat_identification_number": "<string>",
  "tax_code": "<string>",
  "simulation": false,
  "start_date": "2023-12-25",
  "attributes": "<string>"
}
'

import requests

url = "https://api.chargecloud.dev/api/v1/crm/contracts"

payload = {
    "business": False,
    "firstname": "<string>",
    "surname": "<string>",
    "street": "<string>",
    "house_number": "<string>",
    "zip": "<string>",
    "city": "<string>",
    "country_id": 123,
    "billing_firstname": "<string>",
    "billing_surname": "<string>",
    "billing_street": "<string>",
    "billing_house_number": "<string>",
    "billing_zip": "<string>",
    "billing_city": "<string>",
    "billing_email": "<string>",
    "billing_phone": "<string>",
    "ext_contract_id": "<string>",
    "external_customer_id": "<string>",
    "customer_group_id": 123,
    "company_name": "<string>",
    "title": "<string>",
    "date_of_birth": "2023-12-25",
    "phone_home": "<string>",
    "phone_home_area_code": "<string>",
    "phone_mobile": "<string>",
    "phone_mobile_area_code": "<string>",
    "phone_business": "<string>",
    "phone_business_area_code": "<string>",
    "email_private": "<string>",
    "email_business": "<string>",
    "reference_field_1": "<string>",
    "reference_field_2": "<string>",
    "billing_company": "<string>",
    "billing_title": "<string>",
    "billing_country_id": 123,
    "auth_username": "<string>",
    "auth_password": "<string>",
    "advertising_agreement_mail": False,
    "advertising_agreement_phone": False,
    "advertising_agreement_email": False,
    "accept_current_agb": False,
    "accept_current_privacy_policy": False,
    "vat_identification_number": "<string>",
    "tax_code": "<string>",
    "simulation": False,
    "start_date": "2023-12-25",
    "attributes": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    business: false,
    firstname: '<string>',
    surname: '<string>',
    street: '<string>',
    house_number: '<string>',
    zip: '<string>',
    city: '<string>',
    country_id: 123,
    billing_firstname: '<string>',
    billing_surname: '<string>',
    billing_street: '<string>',
    billing_house_number: '<string>',
    billing_zip: '<string>',
    billing_city: '<string>',
    billing_email: '<string>',
    billing_phone: '<string>',
    ext_contract_id: '<string>',
    external_customer_id: '<string>',
    customer_group_id: 123,
    company_name: '<string>',
    title: '<string>',
    date_of_birth: '2023-12-25',
    phone_home: '<string>',
    phone_home_area_code: '<string>',
    phone_mobile: '<string>',
    phone_mobile_area_code: '<string>',
    phone_business: '<string>',
    phone_business_area_code: '<string>',
    email_private: '<string>',
    email_business: '<string>',
    reference_field_1: '<string>',
    reference_field_2: '<string>',
    billing_company: '<string>',
    billing_title: '<string>',
    billing_country_id: 123,
    auth_username: '<string>',
    auth_password: '<string>',
    advertising_agreement_mail: false,
    advertising_agreement_phone: false,
    advertising_agreement_email: false,
    accept_current_agb: false,
    accept_current_privacy_policy: false,
    vat_identification_number: '<string>',
    tax_code: '<string>',
    simulation: false,
    start_date: '2023-12-25',
    attributes: '<string>'
  })
};

fetch('https://api.chargecloud.dev/api/v1/crm/contracts', 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://api.chargecloud.dev/api/v1/crm/contracts",
  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([
    'business' => false,
    'firstname' => '<string>',
    'surname' => '<string>',
    'street' => '<string>',
    'house_number' => '<string>',
    'zip' => '<string>',
    'city' => '<string>',
    'country_id' => 123,
    'billing_firstname' => '<string>',
    'billing_surname' => '<string>',
    'billing_street' => '<string>',
    'billing_house_number' => '<string>',
    'billing_zip' => '<string>',
    'billing_city' => '<string>',
    'billing_email' => '<string>',
    'billing_phone' => '<string>',
    'ext_contract_id' => '<string>',
    'external_customer_id' => '<string>',
    'customer_group_id' => 123,
    'company_name' => '<string>',
    'title' => '<string>',
    'date_of_birth' => '2023-12-25',
    'phone_home' => '<string>',
    'phone_home_area_code' => '<string>',
    'phone_mobile' => '<string>',
    'phone_mobile_area_code' => '<string>',
    'phone_business' => '<string>',
    'phone_business_area_code' => '<string>',
    'email_private' => '<string>',
    'email_business' => '<string>',
    'reference_field_1' => '<string>',
    'reference_field_2' => '<string>',
    'billing_company' => '<string>',
    'billing_title' => '<string>',
    'billing_country_id' => 123,
    'auth_username' => '<string>',
    'auth_password' => '<string>',
    'advertising_agreement_mail' => false,
    'advertising_agreement_phone' => false,
    'advertising_agreement_email' => false,
    'accept_current_agb' => false,
    'accept_current_privacy_policy' => false,
    'vat_identification_number' => '<string>',
    'tax_code' => '<string>',
    'simulation' => false,
    'start_date' => '2023-12-25',
    'attributes' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://api.chargecloud.dev/api/v1/crm/contracts"

	payload := strings.NewReader("{\n  \"business\": false,\n  \"firstname\": \"<string>\",\n  \"surname\": \"<string>\",\n  \"street\": \"<string>\",\n  \"house_number\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"city\": \"<string>\",\n  \"country_id\": 123,\n  \"billing_firstname\": \"<string>\",\n  \"billing_surname\": \"<string>\",\n  \"billing_street\": \"<string>\",\n  \"billing_house_number\": \"<string>\",\n  \"billing_zip\": \"<string>\",\n  \"billing_city\": \"<string>\",\n  \"billing_email\": \"<string>\",\n  \"billing_phone\": \"<string>\",\n  \"ext_contract_id\": \"<string>\",\n  \"external_customer_id\": \"<string>\",\n  \"customer_group_id\": 123,\n  \"company_name\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date_of_birth\": \"2023-12-25\",\n  \"phone_home\": \"<string>\",\n  \"phone_home_area_code\": \"<string>\",\n  \"phone_mobile\": \"<string>\",\n  \"phone_mobile_area_code\": \"<string>\",\n  \"phone_business\": \"<string>\",\n  \"phone_business_area_code\": \"<string>\",\n  \"email_private\": \"<string>\",\n  \"email_business\": \"<string>\",\n  \"reference_field_1\": \"<string>\",\n  \"reference_field_2\": \"<string>\",\n  \"billing_company\": \"<string>\",\n  \"billing_title\": \"<string>\",\n  \"billing_country_id\": 123,\n  \"auth_username\": \"<string>\",\n  \"auth_password\": \"<string>\",\n  \"advertising_agreement_mail\": false,\n  \"advertising_agreement_phone\": false,\n  \"advertising_agreement_email\": false,\n  \"accept_current_agb\": false,\n  \"accept_current_privacy_policy\": false,\n  \"vat_identification_number\": \"<string>\",\n  \"tax_code\": \"<string>\",\n  \"simulation\": false,\n  \"start_date\": \"2023-12-25\",\n  \"attributes\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.chargecloud.dev/api/v1/crm/contracts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business\": false,\n  \"firstname\": \"<string>\",\n  \"surname\": \"<string>\",\n  \"street\": \"<string>\",\n  \"house_number\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"city\": \"<string>\",\n  \"country_id\": 123,\n  \"billing_firstname\": \"<string>\",\n  \"billing_surname\": \"<string>\",\n  \"billing_street\": \"<string>\",\n  \"billing_house_number\": \"<string>\",\n  \"billing_zip\": \"<string>\",\n  \"billing_city\": \"<string>\",\n  \"billing_email\": \"<string>\",\n  \"billing_phone\": \"<string>\",\n  \"ext_contract_id\": \"<string>\",\n  \"external_customer_id\": \"<string>\",\n  \"customer_group_id\": 123,\n  \"company_name\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date_of_birth\": \"2023-12-25\",\n  \"phone_home\": \"<string>\",\n  \"phone_home_area_code\": \"<string>\",\n  \"phone_mobile\": \"<string>\",\n  \"phone_mobile_area_code\": \"<string>\",\n  \"phone_business\": \"<string>\",\n  \"phone_business_area_code\": \"<string>\",\n  \"email_private\": \"<string>\",\n  \"email_business\": \"<string>\",\n  \"reference_field_1\": \"<string>\",\n  \"reference_field_2\": \"<string>\",\n  \"billing_company\": \"<string>\",\n  \"billing_title\": \"<string>\",\n  \"billing_country_id\": 123,\n  \"auth_username\": \"<string>\",\n  \"auth_password\": \"<string>\",\n  \"advertising_agreement_mail\": false,\n  \"advertising_agreement_phone\": false,\n  \"advertising_agreement_email\": false,\n  \"accept_current_agb\": false,\n  \"accept_current_privacy_policy\": false,\n  \"vat_identification_number\": \"<string>\",\n  \"tax_code\": \"<string>\",\n  \"simulation\": false,\n  \"start_date\": \"2023-12-25\",\n  \"attributes\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.chargecloud.dev/api/v1/crm/contracts")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business\": false,\n  \"firstname\": \"<string>\",\n  \"surname\": \"<string>\",\n  \"street\": \"<string>\",\n  \"house_number\": \"<string>\",\n  \"zip\": \"<string>\",\n  \"city\": \"<string>\",\n  \"country_id\": 123,\n  \"billing_firstname\": \"<string>\",\n  \"billing_surname\": \"<string>\",\n  \"billing_street\": \"<string>\",\n  \"billing_house_number\": \"<string>\",\n  \"billing_zip\": \"<string>\",\n  \"billing_city\": \"<string>\",\n  \"billing_email\": \"<string>\",\n  \"billing_phone\": \"<string>\",\n  \"ext_contract_id\": \"<string>\",\n  \"external_customer_id\": \"<string>\",\n  \"customer_group_id\": 123,\n  \"company_name\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date_of_birth\": \"2023-12-25\",\n  \"phone_home\": \"<string>\",\n  \"phone_home_area_code\": \"<string>\",\n  \"phone_mobile\": \"<string>\",\n  \"phone_mobile_area_code\": \"<string>\",\n  \"phone_business\": \"<string>\",\n  \"phone_business_area_code\": \"<string>\",\n  \"email_private\": \"<string>\",\n  \"email_business\": \"<string>\",\n  \"reference_field_1\": \"<string>\",\n  \"reference_field_2\": \"<string>\",\n  \"billing_company\": \"<string>\",\n  \"billing_title\": \"<string>\",\n  \"billing_country_id\": 123,\n  \"auth_username\": \"<string>\",\n  \"auth_password\": \"<string>\",\n  \"advertising_agreement_mail\": false,\n  \"advertising_agreement_phone\": false,\n  \"advertising_agreement_email\": false,\n  \"accept_current_agb\": false,\n  \"accept_current_privacy_policy\": false,\n  \"vat_identification_number\": \"<string>\",\n  \"tax_code\": \"<string>\",\n  \"simulation\": false,\n  \"start_date\": \"2023-12-25\",\n  \"attributes\": \"<string>\"\n}"

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

{
  "contract": {
    "uuid": "<string>",
    "type": "energy",
    "blocked": false,
    "disabled": false,
    "billing_blocked": false,
    "dunning_locked": false,
    "account_id": 123,
    "business": false,
    "salutation": "0",
    "firstname": "<string>",
    "surname": "<string>",
    "street": "<string>",
    "house_number": "<string>",
    "zip": "<string>",
    "city": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "billing_salutation": "0",
    "billing_firstname": "<string>",
    "billing_surname": "<string>",
    "billing_street": "<string>",
    "billing_house_number": "<string>",
    "billing_zip": "<string>",
    "billing_city": "<string>",
    "billing_email": "<string>",
    "billing_phone": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "ordered_at": "2023-11-07T05:31:56Z",
    "status": "open",
    "modification_date": "2023-11-07T05:31:56Z",
    "ext_contract_id": "<string>",
    "external_id": "<string>",
    "customer_group_id": 123,
    "company_name": "<string>",
    "country_id": 123,
    "reference_field_1": "<string>",
    "reference_field_2": "<string>",
    "billing_company": "<string>",
    "billing_title": "<string>",
    "billing_country_id": 123,
    "title": "<string>",
    "tax_code": "<string>",
    "external_customer_id": "<string>",
    "auth_enabled": false,
    "auth_username": "<string>",
    "phone_home": "<string>",
    "phone_home_area_code": "<string>",
    "phone_mobile": "<string>",
    "phone_mobile_area_code": "<string>",
    "phone_business": "<string>",
    "phone_business_area_code": "<string>",
    "email_private": "<string>",
    "email_business": "<string>",
    "advertising_agreement_mail": false,
    "advertising_agreement_phone": false,
    "advertising_agreement_email": false
  },
  "customer_id": 123,
  "external_customer_id": "<string>",
  "mail_verification_needed": false,
  "contract_confirmation_needed": false
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "errors": [
    {
      "errorKey": "<string>",
      "message": "<string>",
      "parameter": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

Authorizations

Authorization

string

header

required

OAuth2 Bearer Authorization

Body

application/json

Creates a contract. Required permission: crm:contracts:create. Available contexts: API Key

business

boolean

default:false

required

Is business customer

salutation

enum<string>

required

Salutation code for the contract holder. New private/business registrations only accept {1, 2, 3, 8}.

Available options:

0,

1,

2,

3,

4,

5,

6,

7,

8,

9,

10

firstname

string

required

Firstname

Maximum string length: 70

surname

string

required

Surname

Maximum string length: 70

street

string

required

Street

Maximum string length: 255

house_number

string

required

House number

Maximum string length: 16

zip

string

required

Postal code of the contract holder's primary address. Length and format are validated against country_id — invalid combinations are rejected.

Maximum string length: 16

city

string

required

City

Maximum string length: 128

country_id

integer<int32>

required

Country id

billing_salutation

enum<string>

required

Salutation code for the billing recipient. Same value set as salutation.

Available options:

0,

1,

2,

3,

4,

5,

6,

7,

8,

9,

10

billing_firstname

string

required

Billing firstname

Maximum string length: 70

billing_surname

string

required

Billing surname

Maximum string length: 70

billing_street

string

required

Billing street

Maximum string length: 255

billing_house_number

string

required

Billing house number

Maximum string length: 16

billing_zip

string

required

Billing ZIP

Maximum string length: 16

billing_city

string

required

Billing city

Maximum string length: 128

billing_email

string

required

Billing email

Maximum string length: 128

billing_phone

string

required

Billing phone

Maximum string length: 128

ext_contract_id

string

Contract identifier as known by an external CRM. This is the primary field used to match ChargeCloud contracts to records in upstream systems (EDI feeds, partner integrations, migrations). Max 50 chars.

Maximum string length: 50

external_customer_id

string

Caller-supplied identifier used to link the customer to an external CRM record. Validation rules can differ per customer group (regex / prefix), so the same value may be accepted for one customer group and rejected for another. Max 15 chars.

Maximum string length: 15

customer_group_id

integer<int32>

Customer group id

company_name

string

Company name

Maximum string length: 255

title

string

Title

Maximum string length: 50

date_of_birth

string<date>

Date of birth

Pattern: ^\d{4}-\d{2}-\d{2}$

phone_home

string

Home phone number

Maximum string length: 50

phone_home_area_code

string

Home phone area code

Maximum string length: 10

phone_mobile

string

Mobile phone number

Maximum string length: 50

phone_mobile_area_code

string

Mobile phone area code

Maximum string length: 10

phone_business

string

Business phone number

Maximum string length: 50

phone_business_area_code

string

Business phone area code

Maximum string length: 10

email_private

string

Private email

Maximum string length: 255

email_business

string

Business email

Maximum string length: 255

reference_field_1

string

Free-text client-configurable reference. Common use cases include TecDoc identifiers, HC (Hauptkunde) numbers, cost centres, purchase-order numbers, and project IDs. No semantic enforcement by the system.

Maximum string length: 255

reference_field_2

string

Second free-text client-configurable reference, parallel to reference_field_1. Same use cases (TecDoc, HC, cost centres, etc.) — provided as a second slot when one reference is not enough.

Maximum string length: 255

billing_company

string

Billing company

Maximum string length: 255

billing_title

string

Billing title

Maximum string length: 70

billing_country_id

integer<int32>

Billing country id

auth_username

string

App login username

Maximum string length: 255

auth_password

string

Auth password

Maximum string length: 128

advertising_agreement_mail

boolean

default:false

Advertising agreement mail

advertising_agreement_phone

boolean

default:false

Advertising agreement phone

advertising_agreement_email

boolean

default:false

Advertising agreement email

accept_current_agb

boolean

default:false

Accept current AGB

accept_current_privacy_policy

boolean

default:false

Accept current privacy policy

vat_identification_number

string

VAT identification number of the business customer. Required for B2B contracts unless a tax_code is supplied instead. Format and check-digit rules apply per country (e.g. DE: "DE" + 9 digits, IT: 11 digits) — invalid values are rejected with HTTP 422.

Maximum string length: 50

tax_code

string

Tax code

Maximum string length: 50

simulation

boolean

default:false

When true, the contract is fully validated and the same response shape is returned, but nothing is saved and no follow-up actions (notifications, downstream sync, emails) are triggered. Use this to pre-validate customer input before the real submission.

start_date

string<date>

Start date

Pattern: ^\d{4}-\d{2}-\d{2}$

attributes

string

JSON-encoded map of contract attributes (e.g. {"attribute_key":"value", ...}). Keys and value types are configured per client — see the Attributes API for the available set. Unknown keys are rejected; optional attributes fall back to their configured default when omitted.

Response

Contract created

contract

object

required

Contract

Show child attributes

customer_id

integer<int32>

Customer ID

external_customer_id

string

External customer ID

mail_verification_needed

boolean

default:false

Mail verification needed

contract_confirmation_needed

boolean

default:false

Contract confirmation needed

⌘I

Getting started - Core

Core API

Authorizations

Body

Response