# Create new keywords

The keyword post will create new keywords and attach those to your account/campaign. This supports multiple keywords in an array of object format. There is validation to ensure that all required fields are met

Endpoint: POST /api/v1/keywords
Version: 2.0.0
Security: JWTAuth

## Request fields (application/json):

  - `account_id` (integer, required)
    Example: 1234567

  - `campaign_id` (integer, required)
    Example: 7654321

  - `keywords` (array, required)

  - `keywords.keyword` (string, required)
    Example: "best hot sauce"

  - `keywords.keyword_type` (string, required)
    Enum: "target", "interest"

## Response 200 fields (application/json):

  - `data` (object, required)
    Example: {"account_id":7654321,"campaign_id":1234546,"keyword":"Keyword","keyword_type":"target"}

  - `data.account_id` (integer)
    Example: 7654321

  - `data.campaign_id` (integer)
    Example: 1234546

  - `data.keyword` (string)
    Example: "Keyword"

  - `data.keyword_type` (string)
    Enum: "target", "interest"

  - `error` (boolean, required)

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":1}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)
    Example: 1

  - `messages` (array, required)
    Example: ["Missing parameter"]

## Response 400 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)
    Example: 1

  - `messages` (array, required)
    Example: ["Missing parameter"]

## Response 401 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)
    Example: 1

  - `messages` (array, required)
    Example: ["Not Authorized"]

## Response 405 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)
    Example: 1

  - `messages` (array, required)
    Example: ["Method Not Allowed"]

## Response 422 fields (application/json):

  - `data` (object, required)
    Example: {}

  - `error` (boolean, required)
    Example: true

  - `pagination` (object, required)
    Example: {"totalPages":1,"maxRows":0,"offset":0,"page":1,"totalRecords":0}

  - `pagination.totalPages` (integer)
    Example: 1

  - `pagination.maxRows` (integer)

  - `pagination.offset` (integer)

  - `pagination.page` (integer)
    Example: 1

  - `pagination.totalRecords` (integer)
    Example: 1

  - `messages` (array, required)
    Example: ["Unprocessable Entity"]