Create plan

POST

https://api.schematichq.com/plans

POST

/plans

1 import { SchematicClient } from "@schematichq/schematic-typescript-node";
2 
3 const client = new SchematicClient({ apiKey: "YOUR_API_KEY" });
4 await client.plans.createPlan({
5     description: "description",
6     name: "name",
7     planType: "plan"
8 });

Try it

201Created

1 {
2   "data": {
3     "charge_type": "free",
4     "company_count": 1,
5     "controlled_by": "schematic",
6     "created_at": "2024-01-15T09:30:00Z",
7     "description": "string",
8     "features": [
9       {
10         "created_at": "2024-01-15T09:30:00Z",
11         "description": "string",
12         "feature_type": "boolean",
13         "flags": [
14           {
15             "created_at": "2024-01-15T09:30:00Z",
16             "default_value": true,
17             "description": "string",
18             "flag_type": "boolean",
19             "id": "string",
20             "key": "string",
21             "name": "string",
22             "rules": [
23               {
24                 "condition_groups": [
25                   {
26                     "conditions": [
27                       {
28                         "condition_type": "string",
29                         "created_at": "2024-01-15T09:30:00Z",
30                         "environment_id": "string",
31                         "id": "string",
32                         "operator": "string",
33                         "resource_ids": [
34                           "string"
35                         ],
36                         "resources": [
37                           {
38                             "id": "string",
39                             "name": "string",
40                             "description": "string",
41                             "image_url": "string"
42                           }
43                         ],
44                         "rule_id": "string",
45                         "trait_value": "string",
46                         "updated_at": "2024-01-15T09:30:00Z",
47                         "comparison_trait": {
48                           "created_at": "2024-01-15T09:30:00Z",
49                           "display_name": "string",
50                           "entity_type": "company",
51                           "hierarchy": [
52                             "string"
53                           ],
54                           "id": "string",
55                           "trait_type": "boolean",
56                           "updated_at": "2024-01-15T09:30:00Z"
57                         },
58                         "comparison_trait_id": "string",
59                         "condition_group_id": "string",
60                         "event_subtype": "string",
61                         "flag_id": "string",
62                         "metric_period": "string",
63                         "metric_period_month_reset": "string",
64                         "metric_value": 1,
65                         "trait": {
66                           "created_at": "2024-01-15T09:30:00Z",
67                           "display_name": "string",
68                           "entity_type": "company",
69                           "hierarchy": [
70                             "string"
71                           ],
72                           "id": "string",
73                           "trait_type": "boolean",
74                           "updated_at": "2024-01-15T09:30:00Z"
75                         },
76                         "trait_entity_type": "company",
77                         "trait_id": "string"
78                       }
79                     ],
80                     "created_at": "2024-01-15T09:30:00Z",
81                     "environment_id": "string",
82                     "id": "string",
83                     "rule_id": "string",
84                     "updated_at": "2024-01-15T09:30:00Z",
85                     "flag_id": "string"
86                   }
87                 ],
88                 "conditions": [
89                   {
90                     "condition_type": "string",
91                     "created_at": "2024-01-15T09:30:00Z",
92                     "environment_id": "string",
93                     "id": "string",
94                     "operator": "string",
95                     "resource_ids": [
96                       "string"
97                     ],
98                     "resources": [
99                       {
100                         "id": "string",
101                         "name": "string",
102                         "description": "string",
103                         "image_url": "string"
104                       }
105                     ],
106                     "rule_id": "string",
107                     "trait_value": "string",
108                     "updated_at": "2024-01-15T09:30:00Z",
109                     "comparison_trait": {
110                       "created_at": "2024-01-15T09:30:00Z",
111                       "display_name": "string",
112                       "entity_type": "company",
113                       "hierarchy": [
114                         "string"
115                       ],
116                       "id": "string",
117                       "trait_type": "boolean",
118                       "updated_at": "2024-01-15T09:30:00Z"
119                     },
120                     "comparison_trait_id": "string",
121                     "condition_group_id": "string",
122                     "event_subtype": "string",
123                     "flag_id": "string",
124                     "metric_period": "string",
125                     "metric_period_month_reset": "string",
126                     "metric_value": 1,
127                     "trait": {
128                       "created_at": "2024-01-15T09:30:00Z",
129                       "display_name": "string",
130                       "entity_type": "company",
131                       "hierarchy": [
132                         "string"
133                       ],
134                       "id": "string",
135                       "trait_type": "boolean",
136                       "updated_at": "2024-01-15T09:30:00Z"
137                     },
138                     "trait_entity_type": "company",
139                     "trait_id": "string"
140                   }
141                 ],
142                 "created_at": "2024-01-15T09:30:00Z",
143                 "environment_id": "string",
144                 "id": "string",
145                 "name": "string",
146                 "priority": 1,
147                 "rule_type": "string",
148                 "updated_at": "2024-01-15T09:30:00Z",
149                 "value": true,
150                 "flag_id": "string"
151               }
152             ],
153             "updated_at": "2024-01-15T09:30:00Z",
154             "feature": {
155               "created_at": "2024-01-15T09:30:00Z",
156               "description": "string",
157               "feature_type": "boolean",
158               "icon": "string",
159               "id": "string",
160               "name": "string",
161               "updated_at": "2024-01-15T09:30:00Z",
162               "event_subtype": "string",
163               "lifecycle_phase": "add_on",
164               "maintainer_id": "string",
165               "plural_name": "string",
166               "singular_name": "string",
167               "trait_id": "string"
168             },
169             "feature_id": "string",
170             "last_checked_at": "2024-01-15T09:30:00Z",
171             "maintainer_id": "string"
172           }
173         ],
174         "icon": "string",
175         "id": "string",
176         "name": "string",
177         "plans": [
178           {
179             "id": "string",
180             "name": "string",
181             "description": "string",
182             "image_url": "string"
183           }
184         ],
185         "updated_at": "2024-01-15T09:30:00Z",
186         "event_subtype": "string",
187         "event_summary": {
188           "company_count": 1,
189           "environment_id": "string",
190           "event_count": 1,
191           "event_subtype": "string",
192           "user_count": 1,
193           "last_seen_at": "2024-01-15T09:30:00Z"
194         },
195         "lifecycle_phase": "add_on",
196         "maintainer_id": "string",
197         "plural_name": "string",
198         "singular_name": "string",
199         "trait": {
200           "created_at": "2024-01-15T09:30:00Z",
201           "display_name": "string",
202           "entity_type": "company",
203           "hierarchy": [
204             "string"
205           ],
206           "id": "string",
207           "trait_type": "boolean",
208           "updated_at": "2024-01-15T09:30:00Z"
209         },
210         "trait_id": "string"
211       }
212     ],
213     "icon": "string",
214     "id": "string",
215     "is_free": true,
216     "is_trialable": true,
217     "name": "string",
218     "plan_type": "plan",
219     "updated_at": "2024-01-15T09:30:00Z",
220     "versions": [
221       {
222         "created_at": "2024-01-15T09:30:00Z",
223         "description": "string",
224         "environment_id": "string",
225         "icon": "string",
226         "id": "string",
227         "name": "string",
228         "plan_type": "plan",
229         "status": "published",
230         "updated_at": "2024-01-15T09:30:00Z",
231         "version": 1,
232         "original_plan_id": "string"
233       }
234     ],
235     "is_default": true,
236     "billing_product": {
237       "account_id": "string",
238       "created_at": "2024-01-15T09:30:00Z",
239       "environment_id": "string",
240       "external_id": "string",
241       "is_active": true,
242       "name": "string",
243       "price": 1.1,
244       "prices": [
245         {
246           "currency": "string",
247           "external_price_id": "string",
248           "id": "string",
249           "interval": "day",
250           "price": 1,
251           "provider_type": "schematic",
252           "scheme": "per_unit",
253           "price_decimal": "string"
254         }
255       ],
256       "product_id": "string",
257       "provider_type": "schematic",
258       "quantity": 1.1,
259       "subscription_count": 1,
260       "updated_at": "2024-01-15T09:30:00Z",
261       "price_decimal": "string",
262       "currency": "string"
263     },
264     "included_credit_grants": [
265       {
266         "auto_topup_enabled": true,
267         "created_at": "2024-01-15T09:30:00Z",
268         "credit_amount": 1,
269         "credit_id": "string",
270         "credit_name": "string",
271         "id": "string",
272         "plan_id": "string",
273         "plan_name": "string",
274         "reset_cadence": "daily",
275         "reset_start": "billing_period",
276         "updated_at": "2024-01-15T09:30:00Z",
277         "auto_topup_amount": 1,
278         "auto_topup_amount_type": "string",
279         "auto_topup_expiry_type": "duration",
280         "auto_topup_expiry_unit": "billing_periods",
281         "auto_topup_expiry_unit_count": 1,
282         "auto_topup_threshold_percent": 1,
283         "credit_plural_name": "string",
284         "credit_singular_name": "string",
285         "expiry_type": "duration",
286         "expiry_unit": "billing_periods",
287         "expiry_unit_count": 1,
288         "reset_type": "no_reset"
289       }
290     ],
291     "monthly_price": {
292       "currency": "string",
293       "external_price_id": "string",
294       "id": "string",
295       "interval": "day",
296       "price": 1,
297       "provider_type": "schematic",
298       "scheme": "per_unit",
299       "price_decimal": "string"
300     },
301     "one_time_price": {
302       "currency": "string",
303       "external_price_id": "string",
304       "id": "string",
305       "interval": "day",
306       "price": 1,
307       "provider_type": "schematic",
308       "scheme": "per_unit",
309       "price_decimal": "string"
310     },
311     "trial_days": 1,
312     "yearly_price": {
313       "currency": "string",
314       "external_price_id": "string",
315       "id": "string",
316       "interval": "day",
317       "price": 1,
318       "provider_type": "schematic",
319       "scheme": "per_unit",
320       "price_decimal": "string"
321     },
322     "audience_type": "string"
323   },
324   "params": {}
325 }

Authentication

X-Schematic-Api-Keystring

API Key authentication via header

Request

This endpoint expects an object.

descriptionstringRequired0-1024 characters

namestringRequired1-256 characters

plan_typeenumRequired

Allowed values:

iconstring or nullOptional<=64 characters

Response

Created

dataobject

paramsobject

Input parameters

Authentication

Request

Response

Errors