--- title: Create transformer --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Logpush](https://developers.cloudflare.com/api/python/resources/logpush) [Transformers](https://developers.cloudflare.com/api/python/resources/logpush/subresources/transformers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create transformer logpush.transformers.create(TransformerCreateParams\*\*kwargs) -> [TransformerCreateResponse]() POST/accounts/{account\_id}/logpush/transformers Creates a new custom log transformer for an account. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Logs Write` ##### ParametersExpand Collapse account\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) code: str The SQL transformer query. Maximum 32 KB. The query must contain a FROM clause referencing a valid logpush dataset. maxLength32768 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20code%20%3E%20(schema)>) name: str Customer-provided name for identification. maxLength255 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>) description: Optional\[str] Optional customer-provided description. maxLength4096 [Link to this property](<#(resource)%20logpush.transformers%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20description%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class TransformerCreateResponse: … id: Optional\[int] The transformer ID. minimum1 Link to this property
associated\_jobs: Optional\[List\[AssociatedJob]] Logpush jobs that reference this transformer. id: Optional\[int] The logpush job ID. Link to this property name: Optional\[str] The logpush job destination name. Link to this property object\_tag: Optional\[str] The zone or account tag. Link to this property
object\_type: Optional\[Literal\["zone", "account"]] Whether the job is zone-scoped or account-scoped. One of the following: "zone" Link to this property "account" Link to this property
Link to this property
Link to this property created\_at: Optional\[datetime] When the transformer was created (RFC 3339). formatdate-time Link to this property dataset: Optional\[str] The dataset this transformer operates on, derived from the SQL query’s FROM clause. Informational only. May be absent if the dataset cannot be determined from the query. Link to this property description: Optional\[str] Optional customer-provided description. maxLength4096 Link to this property name: Optional\[str] Customer-provided name for identification. maxLength255 Link to this property updated\_at: Optional\[datetime] When the transformer was last modified (RFC 3339). formatdate-time Link to this property
[Link to this property](<#(resource)%20logpush.transformers%20%3E%20(model)%20transformer_create_response%20%3E%20(schema)>) ### Create transformer Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) transformer = client.logpush.transformers.create( account_id="023e105f4ecef8ad9ca31a8372d0c353", code="SELECT ClientIP, RayID FROM http_requests", name="redact-pii", ) print(transformer.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": 42, "associated_jobs": [ { "id": 123, "name": "s3-export", "object_tag": "023e105f4ecef8ad9ca31a8372d0c353", "object_type": "zone" } ], "created_at": "2026-08-01T12:00:00Z", "dataset": "http_requests", "description": "Redacts PII fields from HTTP request logs.", "name": "redact-pii", "updated_at": "2026-08-10T15:30:00Z" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": 42, "associated_jobs": [ { "id": 123, "name": "s3-export", "object_tag": "023e105f4ecef8ad9ca31a8372d0c353", "object_type": "zone" } ], "created_at": "2026-08-01T12:00:00Z", "dataset": "http_requests", "description": "Redacts PII fields from HTTP request logs.", "name": "redact-pii", "updated_at": "2026-08-10T15:30:00Z" } } ```