Skip to main content
Create an App
curl --request POST \
  --url https://api.dots.dev/api/v2/apps \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "metadata": {}
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "status": "created",
  "metrics": {
    "wallet_balance": "<string>",
    "money_out": "<string>",
    "connected_users": 123
  },
  "metadata": "<string>"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
name
string
required

The name of the application.

Required string length: 3 - 60
​
metadata

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

Response

201 - application/json

Created

​
id
string<uuid>
required
​
name
string
required
​
metrics
object
required
​
status
enum<string>

App verification status. Some Dots use cases require newly created apps to pass KYB review.

Available options:
created,
in_review,
approved
​
metadata

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.