---
updatedAt: 2026-01-05T21:09:19.000Z
agentTools:
  projectIndex: https://developers.koddi.com/llms.txt
---

# Entity Registration

This endpoint initiates the entity registration for a given Member Group ID and Advertiser ID. Each ID included in the internal\_ids array must separated by commas.

In order to confirm that entities were successfully added, the Entity Registration Failed Report endpoint can be called. This endpoint will detail each of the internal\_ids that were not successfully added to the advertiser.

The Member Group ID will be provided by the Koddi team.

## Response

<HTMLBlock>{`
<style type="text/css">.tg {border-collapse:collapse;border-spacing:0;} .tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px; overflow:hidden;padding:10px 5px;word-break:normal;} .tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px; font-weight:normal;overflow:hidden;padding:10px 5px;word-break:normal;} .tg .tg-viy4{background-color:#FFF;color:#172B4D;text-align:left;vertical-align:top} .tg .tg-ia17{background-color:#F4F5F7;color:#172B4D;font-weight:bold;text-align:left;vertical-align:top} .tg .tg-1dk4{background-color:#F4F5F7;color:#172B4D;text-align:left;vertical-align:top}</style><table id=table1 >
</colgroup><th><tr>
<th>Field<br>
</th><th>Type<br>
</th><th>Description<br>
</th>
</tr>
</thead><tbody><tr>
<td>status</td><td>bool</td><td>Whether the call was a success or failure</td>
  </tr>
<tr>
  <td>result</td><td>array of objects</td><td>Result of the call</td>
  </tr>
<tr>
  <td>event_id</td><td>integer</td><td>ID of the result that is seen on the call.</td>
</tr>
</tbody></table>
`}</HTMLBlock>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "k1-campaign-management",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://koddi.io/console/v1/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-default": "",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/member_groups/{memberGroupId}/advertisers/{advertiserId}/entity_registrations/initiate": {
      "post": {
        "summary": "Entity Registration",
        "description": "",
        "operationId": "entity-registration",
        "parameters": [
          {
            "name": "memberGroupId",
            "in": "path",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          },
          {
            "name": "advertiserId",
            "in": "path",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "internal_ids": {
                    "type": "array",
                    "description": "Bidder id to be added to the advertiser.",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "internal_ids": [
                      "e19adcaa-0113-41e4-8a3e-cfec411d903a",
                      "2f526b72-3558-4eb7-9a5b-b9ebb7cfb794",
                      "e3d7ac66-851d-4107-b5ae-5a0f837f7f94"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"status\": \"success\",\n    \"result\": {\n        \"event_id\": 34\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "success"
                    },
                    "result": {
                      "type": "object",
                      "properties": {
                        "event_id": {
                          "type": "integer",
                          "example": 34,
                          "default": 0
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```