Create Policy | Alchemy Docs

1 curl -X POST https://manage.g.alchemy.com/api/gasManager/policy \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "policyName": "My Policy", 6 "policyType": "sponsorship", 7 "appId": "6d834x9k1yh4dx6z", 8 "networks": [ 9 "foo" 10 ] 11 }'

1 { 2 "data": { 3 "policy": { 4 "policyId": "0x1234567890abcdef", 5 "appId": "0x1234567890abcdef", 6 "status": "active", 7 "rules": { 8 "startTimeUnix": "1674228753", 9 "sponsorshipExpiryMs": "600000", 10 "maxSpendUsd": "5000.00", 11 "maxSpendPerSenderUsd": "100.00", 12 "maxSpendPerUoUsd": "20.00", 13 "maxCount": "100", 14 "maxCountPerSender": "2", 15 "senderAllowlist": [ 16 "foo" 17 ], 18 "senderBlocklist": [ 19 "foo" 20 ], 21 "endTimeUnix": "1679340742", 22 "webhookRules": { 23 "webhookUrl": "https://dashboard.alchemy.com/gas-manager/policy/create", 24 "approveOnFailure": false 25 } 26 }, 27 "policyName": "Gas Manager Policy", 28 "lastUpdatedUnix": "1674228753", 29 "policyVersion": 0, 30 "policyType": "sponsorship", 31 "policyState": "ongoing", 32 "networks": [ 33 "foo" 34 ], 35 "gas_pump_id": "foo", 36 "erc20_rules": { 37 "tokens": [ 38 { 39 "network": "foo", 40 "token_address": "foo", 41 "price_reference_network": "foo", 42 "price_reference_token_address": "foo" 43 } 44 ], 45 "recipient_address": "foo", 46 "use_post_op": true, 47 "price_multiplier": 42, 48 "rules": { 49 "startTimeUnix": "1674228753", 50 "sponsorshipExpiryMs": "600000", 51 "maxSpendUsd": "5000.00", 52 "maxSpendPerSenderUsd": "100.00", 53 "maxSpendPerUoUsd": "20.00", 54 "maxCount": "100", 55 "maxCountPerSender": "2", 56 "senderAllowlist": [ 57 "foo" 58 ], 59 "senderBlocklist": [ 60 "foo" 61 ], 62 "endTimeUnix": "1679340742", 63 "webhookRules": { 64 "webhookUrl": "https://dashboard.alchemy.com/gas-manager/policy/create", 65 "approveOnFailure": false 66 } 67 } 68 }, 69 "solana_rules": { 70 "maxSpendUsd": "6500.00", 71 "maxSpendPerTxnUsd": "30.00", 72 "maxCount": "200", 73 "startTimeUnix": "1674228753", 74 "endTimeUnix": "1679340742" 75 } 76 } 77 }, 78 "error": { 79 "msg": "foo" 80 } 81 }

Creates a new gas manager policy with the specified rules. The newly created policy will be in the `inactive` status. <Note title="Header Access Token"> To call this endpoint, you must use your [access token](/docs/how-to-create-access-keys) in the [authorization header](/docs/how-to-use-api-keys-in-http-headers) of the API request. </Note>

Request

This endpoint expects an object.

policyNamestringRequiredDefaults to My Policy

Name of the policy

policyTypeenumRequiredDefaults to sponsorship

Type of the policy. Currently we support `sponsorship` (for sponsoring gas on EVM networks), `erc20` (for enabling users to pay gas with any ERC-20 token on EVM networks), and `solana` (for sponsoring fees and rent on Solana).

Allowed values:

appIdstringRequiredDefaults to 6d834x9k1yh4dx6z

ID for the app associated with the new policy.

networkslist of stringsRequired

Networks to be enabled for the policy. Example: `ETH_MAINNET`. For Solana policies, valid values are `SOLANA_MAINNET` and `SOLANA_DEVNET`.

rulesobjectOptional

Rules for `sponsorship` policy type. Empty if `policyType` is not `sponsorship`.

solana_rulesobjectOptional

Rules for `solana` policy type. Empty if `policyType` is not `solana`.

erc20_rulesobjectOptional

Rules for `erc20` policy type. Empty if `policyType` is not `erc20`.

Response

Policy created successfully

dataobject

errorobject

Headers

Request

Response