Skip to main content
POST
/
organizations
/
{organizationId}
/
customNetworks
Create a custom network for an organization
curl --request POST \
  --url https://app.dynamicauth.com/api/v0/organizations/{organizationId}/customNetworks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainName": "Base Mainnet",
  "chainId": "8453",
  "rpcUrl": "https://website-sample.com",
  "blockExplorerUrl": "https://website-sample.com",
  "iconUrl": "https://website-sample.com",
  "nativeCurrencyName": "Ethereum",
  "nativeCurrencySymbol": "ETH",
  "nativeCurrencyIconUrl": "https://website-sample.com",
  "nativeCurrencyDecimals": 18
}
'
{
  "customNetwork": {
    "id": "95b11417-f18f-457f-8804-68e361f9164f",
    "chainName": "<string>",
    "chainId": "<string>",
    "rpcUrl": "https://website-sample.com",
    "blockExplorerUrl": "https://website-sample.com",
    "iconUrl": "https://website-sample.com",
    "nativeCurrencyName": "<string>",
    "nativeCurrencySymbol": "<string>",
    "nativeCurrencyIconUrl": "https://website-sample.com",
    "nativeCurrencyDecimals": 9
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.dynamic.xyz/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
organizationId
string
required

ID of organization

Required string length: 36
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

Data to create a custom network

​
networkType
enum<string>
required
Available options:
ETH,
EVM,
FLOW,
SOL,
ALGO,
STARK,
COSMOS,
BTC,
ECLIPSE,
SUI,
SPARK,
TRON,
APTOS,
TON,
STELLAR
​
chainName
string
required

Name of the custom network

Maximum string length: 100
Pattern: ^(?=\S)[\p{L}\p{N} _.,-]+(?<=\S)$
Example:

"Base Mainnet"

​
chainId
string
required

Chain ID of the network

Maximum string length: 100
Pattern: ^[0-9]+$
Example:

"8453"

​
rpcUrl
string
required
Maximum string length: 255
Pattern: ^(https?:\/\/)?[a-z0-9]+([-.]+[a-z0-9]+)*\.[a-z]{2,10}([0-9]{1,5})?(\/.*)?$
Example:

"https://website-sample.com"

​
blockExplorerUrl
string
required
Maximum string length: 255
Pattern: ^(https?:\/\/)?[a-z0-9]+([-.]+[a-z0-9]+)*\.[a-z]{2,10}([0-9]{1,5})?(\/.*)?$
Example:

"https://website-sample.com"

​
iconUrl
string
required
Maximum string length: 255
Pattern: ^(https?:\/\/)?[a-z0-9]+([-.]+[a-z0-9]+)*\.[a-z]{2,10}([0-9]{1,5})?(\/.*)?$
Example:

"https://website-sample.com"

​
nativeCurrencyName
string
required

Full name of the native currency

Maximum string length: 100
Pattern: ^(?=\S)[\p{L}\p{N} _.,-]+(?<=\S)$
Example:

"Ethereum"

​
nativeCurrencySymbol
string
required

Symbol of the native currency

Maximum string length: 100
Pattern: ^[A-Z0-9]{1,10}$
Example:

"ETH"

​
nativeCurrencyIconUrl
string
required
Maximum string length: 255
Pattern: ^(https?:\/\/)?[a-z0-9]+([-.]+[a-z0-9]+)*\.[a-z]{2,10}([0-9]{1,5})?(\/.*)?$
Example:

"https://website-sample.com"

​
nativeCurrencyDecimals
number
required

Number of decimals for the native currency

Required range: 0 <= x <= 18
Example:

18

Response

Custom network created

​
customNetwork
object