--- title: Create a custom provider --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [AI Gateway](https://developers.cloudflare.com/api/go/resources/ai_gateway) [Custom Providers](https://developers.cloudflare.com/api/go/resources/ai_gateway/subresources/custom_providers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a custom provider client.AIGateway.CustomProviders.New(ctx, params) (\*[CustomProviderNewResponse](), error) POST/accounts/{account\_id}/ai-gateway/custom-providers Creates an account-level custom provider that forwards AI Gateway requests to the HTTPS base URL you supply. Requests reference the provider as `custom-{slug}`, so the slug must be unique within the account. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `AI Gateway Write` ##### ParametersExpand Collapse
params CustomProviderNewParams AccountID param.Field\[string] Path param Link to this property BaseURL param.Field\[string] Body param formaturi Link to this property Name param.Field\[string] Body param Link to this property Slug param.Field\[string] Body param Link to this property Beta param.Field\[bool]Optional Body param Link to this property CurlExample param.Field\[string]Optional Body param Link to this property Description param.Field\[string]Optional Body param Link to this property Enable param.Field\[bool]Optional Body param Link to this property Headers param.Field\[string]Optional Body param: JSON object of extra HTTP headers that AI Gateway sends to the provider. Values can contain credentials. maxLength8192 Link to this property JSExample param.Field\[string]Optional Body param Link to this property Link param.Field\[string]Optional Body param Link to this property Position param.Field\[int64]Optional Body param Link to this property
[Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type CustomProviderNewResponse struct{…} ID string formatuuid Link to this property BaseURL string formaturi Link to this property CreatedAt Time formatdate-time Link to this property ModifiedAt Time formatdate-time Link to this property Name string Link to this property Slug string Link to this property Beta boolOptional Link to this property CurlExample stringOptional Link to this property Description stringOptional Link to this property Enable boolOptional Link to this property Headers stringOptional JSON object of extra HTTP headers that AI Gateway sends to the provider. Values can contain credentials. maxLength8192 Link to this property JSExample stringOptional Link to this property Link stringOptional Link to this property Logo stringOptional Link to this property Position int64Optional Link to this property
[Link to this property](<#(resource)%20ai_gateway.custom_providers%20%3E%20(model)%20CustomProviderNewResponse%20%3E%20(schema)>) ### Create a custom provider Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/ai_gateway" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) customProvider, err := client.AIGateway.CustomProviders.New(context.TODO(), ai_gateway.CustomProviderNewParams{ AccountID: cloudflare.F("3ebbcb006d4d46d7bb6a8c7f14676cb0"), BaseURL: cloudflare.F("https://example.com"), Name: cloudflare.F("name"), Slug: cloudflare.F("slug"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", customProvider.ID) } ``` 200 example ``` { "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "base_url": "https://example.com", "created_at": "2019-12-27T18:11:19.117Z", "modified_at": "2019-12-27T18:11:19.117Z", "name": "name", "slug": "slug", "beta": true, "curl_example": "curl_example", "description": "description", "enable": true, "headers": "headers", "js_example": "js_example", "link": "link", "logo": "logo", "position": 0 }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "base_url": "https://example.com", "created_at": "2019-12-27T18:11:19.117Z", "modified_at": "2019-12-27T18:11:19.117Z", "name": "name", "slug": "slug", "beta": true, "curl_example": "curl_example", "description": "description", "enable": true, "headers": "headers", "js_example": "js_example", "link": "link", "logo": "logo", "position": 0 }, "success": true } ```