---
id: provider-create
title: "Create a provider"
description: "Creates a new provider. Note that [dependencies](/docs/providers/overview#provider-dependencies) may need to be met."
sidebar_label: "Create a provider"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/api/providers
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create a provider"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/provider"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Creates a new provider. Note that [dependencies](/docs/providers/overview#provider-dependencies) may need to be met.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"title":"ProviderCreate","description":"Object to create a new provider","properties":{"nrn":{"title":"NRN","type":"string","pattern":"^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources"},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"attributes":{"type":"object","description":"Provider-specific attributes defined in the specification schema"},"dimensions":{"type":"object","description":"NRN-specific dimensions. [Read more](/docs/dimensions)"},"tags":{"type":"array","description":"Tags associated with the provider","items":{"type":"object","properties":{"key":{"type":"string","description":"Tag key"},"value":{"type":"string","description":"Tag value"}},"required":["key","value"],"additionalProperties":false}}},"required":["nrn","specification_id","attributes"],"example":{"nrn":"organization=1:account=1:namespace=1","dimensions":{"environment":"production"},"specification_id":"02fd22f1-6bf9-41aa-9b58-29d50f725855","attributes":{"cluster":{"id":"my-np-gcp-prod","location":"s-west1","namespace":"my-namespace"},"gateway":{"public_name":"my-public-gateway","private_name":"my-private-gateway"}},"tags":[{"key":"cluster.id","value":"my-np-gcp-prod"}]}}}},"description":"Object to create a new provider"}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing a provider resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"nrn":{"title":"NRN","type":"string","pattern":"^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources"},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"attributes":{"type":"object","description":"Provider-specific attributes defined in the specification schema"},"dimensions":{"type":"object","description":"NRN-specific dimensions. [Read more](/docs/dimensions)"},"tags":{"type":"array","description":"Tags associated with the provider","items":{"type":"object","properties":{"key":{"type":"string","description":"Tag key"},"value":{"type":"string","description":"Tag value"},"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"}},"required":["key","value","id"],"additionalProperties":false}},"groups":{"type":"array","items":{"type":"string"},"description":"Groups associated with the provider"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp"}},"title":"ProviderRead","description":"Object representing a provider resource","example":{"id":"a3f1c2d4-e5b6-7890-ab12-cdef34567890","nrn":"organization=1:account=1:namespace=1","dimensions":{"environment":"production"},"specification_id":"02fd22f1-6bf9-41aa-9b58-29d50f725855","attributes":{"cluster":{"id":"my-np-gcp-prod","location":"s-west1","namespace":"my-namespace"},"gateway":{"public_name":"my-public-gateway","private_name":"my-private-gateway"}},"tags":[{"id":"4e2306de-82e3-4b74-a419-e0e324beb500","key":"cluster.id","value":"my-np-gcp-prod"}],"created_at":"2024-10-15T08:30:00Z","updated_at":"2024-10-20T14:45:00Z"},"required":["id","nrn","specification_id","attributes","created_at","updated_at"]}}}},"4XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}},"5XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}}}}
>
  
</StatusCodes>