TEtenderly
Wallets

Add wallets to a project in bulk

Changed on

Add many wallet addresses to a project in one request. Each wallet lists one or more networks, and each address and network combination is one wallet-network pair. A request takes at most 100 pairs; a pair repeated in the request counts once.

The response sorts the requested addresses into two lists:

  • added: wallets this request added to the project.
  • existing: addresses the project already had, as wallets or contracts. Their type and display name are not changed, so sending the same list again is safe.

An address is added as a wallet even when it is a contract. Every network must be a public network supported by Tenderly. An unsupported network returns 400 and nothing is added. If the new addresses would exceed your account's address limit, the request returns 403 and nothing is added.

Tags

Tags are added on every network the wallet is listed on, including addresses the project already had. Tags the address already has are kept; this endpoint never removes tags. A request that includes tags requires the update_contract project permission in addition to add_contract. Tagged addresses can be targeted as a group by alerts.

post/v2/accounts/{accountSlug}/projects/{projectSlug}/wallets

Request

Path parameters

accountSlugstring required

Account slug of the user

projectSlugstring required

Project slug of the account

Request body

Example request

{
  "wallets": [
    {
      "address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
      "network_ids": [
        "1",
        "8453"
      ],
      "display_name": "Treasury",
      "tags": [
        "treasury"
      ]
    }
  ]
}

Response

A successful response.

Example response

{
  "added": [
    {
      "id": "eth:1:0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
      "contract": {
        "id": "eth:1:0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "network_id": "1",
        "address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "type": "wallet"
      },
      "project_id": "dfdc391a-a15d-4590-9aef-8691259c7df4",
      "added_by_id": "7d5e8b1f-8bf8-4eae-a70f-fb7d354b1cc2",
      "display_name": "Treasury",
      "account_type": "wallet",
      "tags": [
        {
          "tag": "treasury",
          "created_at": "2026-10-02T09:14:07.512Z"
        }
      ],
      "details_visible": true,
      "include_in_transaction_listing": true,
      "added_at": "2026-10-02T09:14:07.498Z"
    }
  ],
  "existing": [
    {
      "id": "eth:1:0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
      "contract": {
        "id": "eth:1:0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "network_id": "1",
        "address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
        "type": "wallet"
      },
      "project_id": "dfdc391a-a15d-4590-9aef-8691259c7df4",
      "added_by_id": "7d5e8b1f-8bf8-4eae-a70f-fb7d354b1cc2",
      "display_name": "Treasury",
      "account_type": "wallet",
      "tags": [
        {
          "tag": "treasury",
          "created_at": "2026-10-02T09:14:07.512Z"
        }
      ],
      "details_visible": true,
      "include_in_transaction_listing": true,
      "added_at": "2026-10-02T09:14:07.498Z"
    }
  ]
}

Changes