---
title: "Create a table from a subdomain search"
method: POST
path: "/find-subdomains/tables/"
tags: ["find-subdomains"]
---

# Create a table from a subdomain search

`POST /find-subdomains/tables/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/find-subdomains/tables/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Land a finished search's hostnames into a new table, one row per hostname. Separate from the search itself so results can be reviewed before a table is committed.

## Request body

- CreateTableFromSubdomainSearchRequestSchema: Turn a finished search into a table.
  - `folder_id` string, uuid, nullable: The folder to make the table in, as when the search is started from inside one on the Tables list. Leave it out for the top level.
  - `search_id` string, uuid, required
  - `table_name` string, required

## Response `201`

Successful Response

- CreateTableFromSubdomainSearchResponseSchema: The table a search was turned into.
  - `hostnames_found` integer, required: What the search found, before any cap. Larger than rows_created when the per-search cap trimmed what was stored or the organisation's per-table row limit clamped the landing.
  - `rows_created` integer, required
  - `table_id` string, uuid, required
  - `table_name` string, required

## Other responses

- `401`: Unauthorized
- `402`: Not enough credits, or the plan does not allow a table this size.
- `403`: Forbidden
- `404`: No such subdomain search or folder.
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)