> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# developerConnectionCreate

> Create a developer connection that HTTP request steps can call. Pass its secret here, or omit it and set it later. Errors with CONNECTION_NAME_TAKEN when the name is in use and CONNECTION_INVALID when a setting fails its rules.

**Required scopes:** [`developer_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-developer_write)

## Arguments

**input** `[DeveloperConnectionCreateInput!](/docs/api-reference/v3/reference/developer/developer-connection-create-input)` *required*

The connection to create.

**fields**

**http** `[HttpDeveloperConnectionInput!](/docs/api-reference/v3/reference/developer/http-developer-connection-input)` *required*

The connection's HTTP settings.

**fields**

**authScheme** `[HttpAuthScheme!](/docs/api-reference/v3/reference/developer/http-auth-scheme)` *required*

How the secret is sent. It can't change later.

**baseUrl** `String!` *required*

An `https://` URL on a public domain, such as `https://api.example.com/v1`. Request paths are joined to it.

**headerName** `String`

The header the secret is sent in. Required for HEADER.

**username** `String`

The username sent with the secret. Required for BASIC.

**name** `String!` *required*

A name, unique in the store.

**secret** `String`

Write-only: never returned. The token, password or header value the connection sends, as its `authScheme` says. Omit it to create the connection without one and set it later with `developerConnectionSecretSet`; requests through it fail until then.

## Returns

**developerConnectionCreate** `[DeveloperConnection!](/docs/api-reference/v3/reference/developer/developer-connection)` *required*

A saved address and secret that automations use to call another service, from Developer › Connections. The secret is write-only: no field returns it, and `secretSet` says whether one is stored.

**fields**

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the connection was created.

**id** `ID!` *required*

The id of this connection. An HTTP request step names it as its connection.

**lastError** `String`

Why the last request through the connection failed. Null when it succeeded or none was sent.

**lastUsedAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When an automation last sent a request through the connection. Null when none has.

**name** `String!` *required*

The connection's name, unique in the store.

**secretSet** `Boolean!` *required*

Whether a secret is stored. Requests through a connection without one fail.

**type** `[DeveloperConnectionType!](/docs/api-reference/v3/reference/developer/developer-connection-type)` *required*

What the connection connects to.

**updatedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the connection's name, settings or secret last changed.

**Possible types:** [`HttpDeveloperConnection`](https://developers.redo.com/docs/api-reference/v3/reference/developer/http-developer-connection)

## Example

```graphql theme={null}
mutation {
  developerConnectionCreate(input: { ... }) {
    createdAt
    id
    lastError
    lastUsedAt
    name
    secretSet
    type
    updatedAt
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.