---
title: "Generate App Url"
method: POST
path: "/v0/app-urls"
tags: ["App URLs", "App URLs"]
---

# Generate App Url

`POST /v0/app-urls`

Build a deep link into the TheirStack app for a given resource and return it as `{"url": ...}`. Pick the resource with the `type` field: `company_list` (view a list), `job_search` / `company_search` (open a search from filters — same filter shape as `search_jobs_v1` / `search_companies_v1`), `saved_search` (open a saved search), or `webhook` (view a webhook). Search links (`job_search` / `company_search`) are workspace-independent — the encoded query opens against whoever's session loads it, so the link is portable when shared. The other types point at a workspace-specific resource and include the workspace, which is taken from the authenticated caller, so it is never passed in.

## Request body

- union
  - CompanyListUrlRequestV0
    - `type` 'company_list', required
    - `list_id` integer, required — ID of the company list to open
  - JobSearchUrlRequestV0
    - `type` 'job_search', required
    - `filters` object — Job search filters, same shape as the `search_jobs_v1` request body. The URL opens the jobs search with these filters applied and runs the search automatically.
  - CompanySearchUrlRequestV0
    - `type` 'company_search', required
    - `filters` object — Company search filters, same shape as the `search_companies_v1` request body. The URL opens the companies search with these filters applied and runs the search automatically.
  - SavedSearchUrlRequestV0
    - `type` 'saved_search', required
    - `saved_search_id` integer, required — ID of the saved search to open
    - `search_type` 'jobs' | 'companies', required — Whether the saved search is a jobs or a companies search
  - WebhookUrlRequestV0
    - `type` 'webhook', required
    - `webhook_id` integer, required — ID of the webhook to open

## Response `200`

Successful Response

- AppUrlResponseV0
  - `url` string, required — Full workspace-scoped URL into the TheirStack app

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/revisions/61aa71ad4ecb/schema)