---
title: "POST /v1/{+parent}/externalApis"
method: POST
path: "/v1/{+parent}/externalApis"
tags: ["projects"]
---

# POST /v1/{+parent}/externalApis

`POST /v1/{+parent}/externalApis`

Create an External API resource in the API hub.

## Path parameters

- `parent` string, required

## Query parameters

- `externalApiId` string

## Request body

- GoogleCloudApihubV1ExternalApi — An external API represents an API being provided by external sources. This can be used to model third-party APIs and can be used to define dependencies.
  - `updateTime` string, google-datetime — Output only. Last update timestamp.
  - `createTime` string, google-datetime — Output only. Creation timestamp.
  - `description` string — Optional. Description of the external API. Max length is 2000 characters (Unicode Code Points).
  - `attributes` object — Optional. The list of user defined attributes associated with the Version resource. The key is the attribute name. It will be of the format: `projects/{project}/locations/{location}/attributes/{attribute}`. The value is the attribute values associated with the resource.
  - `name` string — Identifier. Format: `projects/{project}/locations/{location}/externalApi/{externalApi}`.
  - `endpoints` string[] — Optional. List of endpoints on which this API is accessible.
  - `displayName` string — Required. Display name of the external API. Max length is 63 characters (Unicode Code Points).
  - `documentation` GoogleCloudApihubV1Documentation — Documentation details.
    - `externalUri` string — Optional. The uri of the externally hosted documentation.
  - `paths` string[] — Optional. List of paths served by this API.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/apihub.md) · [All operations](https://skmtc.dev/google/apis/apihub/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/apihub/revisions/19473c7df886/schema)