@wevion/cli 1.0.3180 → 1.0.3182

package/openapi.json

@@ -145762,6 +145762,478 @@
         }
       }
     },
+    "/api/v1/meta/lead-forms": {
+      "post": {
+        "operationId": "postApiV1MetaLeadForms",
+        "summary": "Create a Meta Instant Form",
+        "tags": [
+          "meta"
+        ],
+        "description": "Creates a lead-generation Instant Form on a connected Facebook Page (`POST /{page_id}/leadgen_forms`) and returns its id, ready to attach to an ad. Meta publishes forms immutable: questions, privacy policy and the quality filters (SMS verification, higher-intent review step) can only be chosen at creation, so an existing form can never be upgraded — a new one is created instead. The Page access token is resolved server-side from the connected Page; the caller never handles Meta tokens.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "page_id",
+                  "name",
+                  "questions"
+                ],
+                "properties": {
+                  "page_id": {
+                    "minLength": 1,
+                    "description": "Facebook Page that will own the form.",
+                    "type": "string"
+                  },
+                  "name": {
+                    "minLength": 1,
+                    "maxLength": 200,
+                    "description": "Internal form name, shown in the picker.",
+                    "type": "string"
+                  },
+                  "questions": {
+                    "minItems": 1,
+                    "maxItems": 30,
+                    "description": "Questions in display order. At least one is required by Meta.",
+                    "type": "array",
+                    "items": {
+                      "additionalProperties": false,
+                      "type": "object",
+                      "required": [
+                        "type"
+                      ],
+                      "properties": {
+                        "type": {
+                          "anyOf": [
+                            {
+                              "type": "string",
+                              "enum": [
+                                "FULL_NAME"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "FIRST_NAME"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "LAST_NAME"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "EMAIL"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "PHONE"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "PHONE_OTP"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "WHATSAPP_NUMBER"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "STREET_ADDRESS"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "CITY"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "STATE"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "PROVINCE"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "COUNTRY"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "POST_CODE"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "ZIP"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "COMPANY_NAME"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "JOB_TITLE"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "WORK_EMAIL"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "WORK_PHONE_NUMBER"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "DOB"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "GENDER"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "MARITAL_STATUS"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "RELATIONSHIP_STATUS"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "MILITARY_STATUS"
+                              ]
+                            },
+                            {
+                              "type": "string",
+                              "enum": [
+                                "CUSTOM"
+                              ]
+                            }
+                          ]
+                        },
+                        "key": {
+                          "maxLength": 100,
+                          "type": "string"
+                        },
+                        "label": {
+                          "maxLength": 300,
+                          "type": "string"
+                        },
+                        "options": {
+                          "maxItems": 30,
+                          "type": "array",
+                          "items": {
+                            "additionalProperties": false,
+                            "type": "object",
+                            "required": [
+                              "value"
+                            ],
+                            "properties": {
+                              "value": {
+                                "maxLength": 200,
+                                "type": "string"
+                              },
+                              "key": {
+                                "maxLength": 100,
+                                "type": "string"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  },
+                  "locale": {
+                    "maxLength": 10,
+                    "description": "Form locale, e.g. \"it_IT\". Defaults to the Page locale.",
+                    "type": "string"
+                  },
+                  "privacy_policy_url": {
+                    "format": "uri",
+                    "maxLength": 1000,
+                    "description": "Required by Meta before a form can serve.",
+                    "type": "string"
+                  },
+                  "privacy_policy_link_text": {
+                    "maxLength": 100,
+                    "type": "string"
+                  },
+                  "context_card_title": {
+                    "maxLength": 200,
+                    "type": "string"
+                  },
+                  "context_card_content": {
+                    "maxItems": 10,
+                    "type": "array",
+                    "items": {
+                      "maxLength": 300,
+                      "type": "string"
+                    }
+                  },
+                  "context_card_button_text": {
+                    "maxLength": 100,
+                    "type": "string"
+                  },
+                  "thank_you_title": {
+                    "maxLength": 200,
+                    "type": "string"
+                  },
+                  "thank_you_body": {
+                    "maxLength": 500,
+                    "type": "string"
+                  },
+                  "thank_you_button_text": {
+                    "maxLength": 100,
+                    "type": "string"
+                  },
+                  "thank_you_website_url": {
+                    "format": "uri",
+                    "maxLength": 1000,
+                    "type": "string"
+                  },
+                  "follow_up_action_url": {
+                    "format": "uri",
+                    "maxLength": 1000,
+                    "type": "string"
+                  },
+                  "phone_sms_verify": {
+                    "type": "boolean"
+                  },
+                  "optimized_for_quality": {
+                    "type": "boolean"
+                  },
+                  "block_display_for_non_targeted_viewer": {
+                    "type": "boolean"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-team-id",
+            "required": false,
+            "description": "Explicit team (workspace) scope: a team.id the caller belongs to."
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "header",
+            "name": "x-active-scope",
+            "required": false,
+            "description": "Active scope selector in `<scopeType>:<uuid>` form, e.g. `organization:<organization_id>` or `team:<team_id>`. Omit the header for the all-workspaces view."
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Form created on the Page.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Form created on the Page.",
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "name",
+                    "page_id"
+                  ],
+                  "properties": {
+                    "id": {
+                      "description": "Meta leadgen form id, ready to attach to an ad.",
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "page_id": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid form definition, e.g. SMS verification without a phone question.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Invalid form definition, e.g. SMS verification without a phone question.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "The Page is not connected to the caller team.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "The Page is not connected to the caller team.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Meta refused the form: missing permission, invalid privacy policy, and similar.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Meta refused the form: missing permission, invalid privacy policy, and similar.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Unexpected server error.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Unexpected server error.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "number"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ]
+      }
+    },
     "/api/v1/meta/users/deactivate": {
       "post": {
         "operationId": "postApiV1MetaUsersDeactivate",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wevion/cli",
-  "version": "1.0.3180",
+  "version": "1.0.3182",
   "description": "Wevion API command-line interface — generated from the public OpenAPI spec",
   "type": "module",
   "bin": {