Create a goal

Query Parameters

mushafId integer required

Possible values: [1, 2, 3, 4, 5, 6, 7, 11]

The id of the Mushaf being used.

1 = QCFV2

2 = QCFV1

3 = Indopak

4 = UthmaniHafs

5 = KFGQPCHAFS

6 = Indopak15Lines

7 = Indopak16Lines

11 = Tajweeed

Header Parameters

x-timezone string

The current timezone of the user. Not providing the value might affect the accuracy of how we calculate days and streaks.

application/json

Request Body

type string required

Possible values: [QURAN_TIME, QURAN_PAGES, QURAN_RANGE, COURSE]

The type of the goal.

amount object required

The amount of the goal. Depending on the goal type, the amount value and format will be different

oneOf

string

integer

string

The amount of the goal. Depending on the goal type, the amount value and format will be different

duration integer

Possible values: >= 1

The duration of the goal in days. If it's empty it means the goal is a daily goal and not duration-based.

category string required

Possible values: [QURAN, COURSE]

The category of the goal

Responses

Request has been handled successfully.

application/json

Schema

Example (from schema)

Schema

success boolean

data object

id string required

The id of the goal.

{
  "success": true,
  "data": {
    "id": "clz2z4joc000d0nq9aleh50fy"
  }
}

Forbidden error. Can either be due to access token not being passed, having been expired or the caller trying to access a resource without enough permissions.

application/json

Schema

Example (from schema)

Schema

success boolean

error object

code string

message string

{
  "success": false,
  "error": {
    "code": "ForbiddenError",
    "message": "Token expired"
  }
}

Not Found. The resource being accessed does not exist.

application/json

Schema

Example (from schema)

Schema

success boolean

error object

code string

message string

{
  "success": false,
  "error": {
    "code": "NotFoundError",
    "message": "The resource you're looking for does not exist"
  }
}

Validation Error. The request includes one or more invalid params. Please check the request params and try again.

application/json

Schema

Example (from schema)

Schema

success boolean

error object

code string

message string

{
  "success": false,
  "error": {
    "code": "ValidationError",
    "message": "`id` is required"
  }
}

Server Error. Something went wrong, try again later.

application/json

Schema

Example (from schema)

Schema

success boolean

error object

code string

message string

{
  "success": false,
  "error": {
    "code": "ServerError",
    "message": "Something went wrong"
  }
}

Create a goal​

Create a goal