Documentation

Simple API (Beta)

Create new DataSets and import data into DataSets using the Simple API

The Simple API allows you to create new DataSets and import data into the DataSets in your Domo instance.

Note: Domo’s Simple API is currently in beta. To be included in the beta and start using the Simple API please contact us at Beta.admin@domo.com.

Create DataSet

Creates a new DataSet in your Domo instance. Once the DataSet has been created, data can then be imported into the DataSet.

Definition

POST https://api.domo.com/v1/json

Arguments

Property Name Type Required Description
name String Required Name of the DataSet to create
description String Required Description of DataSet to create

Sample Request

POST https://api.domo.com/v1/json
Content-Type: application/json
Accept: application/json
Authorization: bearer <your-valid-oauth-access-token>

{
  "name": "Leonhard Euler Party",
  "description": "Mathematician Guest List"
}

Sample Response

HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "4405ff58-1957-45f0-82bd-914d989a3ea3",
"name": "Leonhard Euler Party",
"description": "Mathematician Guest List",
"rows": 0,
"columns": 0,
"owner": {
    "id": 27,
    "name": "DomoSupport"
  },
"createdAt": "2016-06-21T17:20:36Z",
"updatedAt": "2016-06-21T17:20:36Z"
}

Import data into DataSet

Imports data into an already existing DataSet in your Domo instance.

Definition

PUT https://api.domo.com/v1/json/{DATASET_ID}/data

Arguments

Property Name Type Required Description
dataset_id string Required The ID of the DataSet to have data imported

Sample Request

PUT https://api.domo.com/v1/json/4405ff58-1957-45f0-82bd-914d989a3ea3/data
Content-Type: application/json
Accept: application/json
Authorization: bearer <your-valid-oauth-access-token>

[
    {
        "Friend":"John",
        "Attending": "false"
    },
        {
        "Friend":"Jane",
        "Attending": "true"
    }
]

Sample Response

HTTP/1.1 204 No Content