POST /entries

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

post
Create entry in chain

https://api.de-facto.pro/v1/entries
chain_id and content are required parameters to create new entry in the chain.
Request
Response
Headers
X-Api-Key
required
string
Authentication token to access the API. Keep it in secret.
Form Data Parameters
chain_id
required
string
Chain ID of the Factom chain where to add new entry.
content
required
string
The content of new entry.
external_ids
optional
array
One or many external ids identifying new entry. Should be sent as array of strings.
200: OK
Entry object returned on success
{
"result": {
"chain_id": "12a260f886ce78751cde9882d6897d6a04a847c56ef488ef9f14f15a25589e5f",
"entry_hash": "bdc15c0eff8eed81695690c484fdb1f6e241e7c82b93e5bf2d9054eb7f0a09d1",
"content": "Queue test content",
"external_ids": [
"Queue test",
"Test #3"
],
"status": "queue"
}
}
400: Bad Request
Example of error
{
"result": false,
"code": 400,
"error": "Chain e67c445b220b806fff4a31f6ef8e7934a9ee543567e28e87b9c0bf500990f001 not found"
}

There are 3 stages of processing entries. Current processing stage returned in {"status"}.

  • queue — entry received and will be processed soon

  • processing — entry sent to the Factom network and will be included in the next block

  • completed — entry processed and available on the Factom

Usually, {"status":"queue"} returned while creating new entries.