POST /chains

This endpoint allows you to create new chain on the Factom blockchain.

post
Create chain
http://localhost:8081/v1/chains
Important!
`content` and `extIds` are sent and received into Base64 format.
Open API SDKs automatically convert the data into Base64.
Request
Response
Request
Query Parameters
callback_url
optional
string
URL for status callbacks
Body Parameters
extIds
required
string
One or many external ids identifying new chain. Should be sent as array of strings.
content
optional
string
The content of the first entry of the chain.
Response
200: OK
Success
{
    "result": {
        "chainId": "9aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0",
        "extIds": [
            "RmFjdG9tIE9wZW4gQVBJ",
            "UEhQIFNESyBUZXN0"      
        ],
        "status": "queue",
        "synced": false,
        "createdAt": "2019-04-18T20:03:00Z",
        "links": [
            {
                "rel": "firstEntry",
                "href": "/entries/a773592954dfbcedc538eb89d39166b9a00ffa5e0114f383ff849e47839f6938"
            }
        ]
    }
}
400: Bad Request
Chain already exists
Validation error
Pagination error
{
    "result": false,
    "code": 1420,
    "error": "Chain 9aa8eebdaa9e6ba6790dd27692519530c046e08be73fe488597947205cc563c0 already exists"
}
500: Internal Server Error
Internal server error
API user's limit exceeded
{
    "result": false,
    "code": 1510,
    "error": "Internal server error"
}
​

User - Previous

GET /user

Next - Chains

GET /chains

Last updated 10 months ago

POST /chains

postCreate chain

post
Create chain